Skip to main content

A MCPServer for partial APIs of the Taiwan Stock Exchange OpenAPI.

Project description

🚀 TWStockMCPServer

License: MIT Python MCP API Tests

一個全面的模型上下文協議 (MCP) 伺服器,專為台灣證券交易所 (TWSE) 數據分析設計,提供即時股票資訊、財務報表、ESG 數據和趨勢分析功能。

🌏 語言版本

🎬 示範影片

VSCode Copilot demo

VSCode Copilot demo

Gemini CLI demo

Gemini CLI demo

觀看 TWStockMCPServer 功能展示

✨ 五大投資分析情境

📊 個股趨勢研判

短中長期技術面、基本面、籌碼面綜合分析

"分析台積電(2330)最近的走勢" / "鴻海(2317)適合長期投資嗎?"

💰 外資投資解讀

外資持股、產業流向、個股進出追蹤

"外資最近在買什麼股票?" / "半導體業外資投資趨勢如何?"

🔥 市場熱點捕捉

重大訊息、異常成交、權證活躍度監控

"今天有什麼重大消息?" / "哪些股票交易量異常活躍?"

💎 股利投資規劃

高殖利率篩選、除權息行事曆、配息穩定性分析

"推薦一些高殖利率股票" / "下個月有哪些公司要除權息?"

🎯 投資標的篩選

價值股/成長股篩選、ESG風險評估

"幫我找一些被低估的價值股" / "ESG表現好的公司有哪些?"

📈 API 整合進度

目前進度:143/143 (100.0%) 已完成 ✅

想了解詳細的API覆蓋情況?查看我們的 API TODO List 追蹤實作進度!

💡 執行 python generate_todo.py 可自動更新進度統計

⚙️ 快速開始

🚀 線上使用(推薦)

{
  "twstockmcpserver": {
    "transport": "streamable_http",
    "url": "https://TW-Stock-MCP-Server.fastmcp.app/mcp"
  }
}

🔧 本地安裝

git clone https://github.com/twjackysu/TWStockMCPServer.git
cd TWStockMCPServer
uv sync && uv run fastmcp dev server.py

🤝 參與貢獻

歡迎PR!查看現有API列表了解可擴展的功能。

📄 授權 & 免責聲明

MIT授權 | 僅供參考,不構成投資建議

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_twjackysu_twstockmcpserver-0.1.0.tar.gz (52.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_twjackysu_twstockmcpserver-0.1.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_twjackysu_twstockmcpserver-0.1.0.tar.gz
  • Upload date:
  • Size: 52.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_twjackysu_twstockmcpserver-0.1.0.tar.gz
Algorithm Hash digest
SHA256 962af137bcd4b67358eb232481bcaa22ced5199ba1cfdff22824db2d4d38e6b3
MD5 e88359915627e81d7f1933354adce627
BLAKE2b-256 db781d3fe65d6f58bd706dde95b0423f7aaf598f69b868c1f688d239d7f96866

See more details on using hashes here.

File details

Details for the file iflow_mcp_twjackysu_twstockmcpserver-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_twjackysu_twstockmcpserver-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 72.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_twjackysu_twstockmcpserver-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 de5d1fac0dc9bf236933c3d59a5bed683f6cf0ccdce974e4331ca686b9801c12
MD5 fc7169d46f6d567dd3aba5b9298ecd2d
BLAKE2b-256 0297f19edb3770f9af7e3108bbbf0019a49a09a6f73e8328087a2741de584c61

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page