Fubon MCP Server
mingyaw
README
Fubon MCP Server
富邦證券市場資料 MCP (Model Communication Protocol) 伺服器，用於獲取台股歷史數據。
功能特點
- 支援台股及 ETF 歷史 K 線數據查詢
- 本地數據快取，減少 API 呼叫次數
- 自動分段處理長時間區間的數據請求
- 支援數據去重和排序
- 提供額外計算欄位（成交值、漲跌、漲跌幅）
系統需求
- Python 3.8 或以上版本
- 富邦證券電子憑證
- macOS / Linux / Windows
安裝說明
- 克隆專案：
git clone https://github.com/yourusername/fubon-mcp-server.git
cd fubon-mcp-server
- 建立虛擬環境：
python3 -m venv .venv
source .venv/bin/activate # macOS/Linux
# 或
.venv\Scripts\activate # Windows
- 安裝相依套件：
pip install -r requirements.txt
- 設定環境變數：
將以下環境變數加入到 .env 檔案：
FUBON_USERNAME=您的富邦證券帳號
FUBON_PASSWORD=您的富邦證券密碼
FUBON_PFX_PATH=/path/to/your/certificate.pfx
FUBON_DATA_DIR=/path/to/your/data/directory
使用方法
- 啟動伺服器：
python server.py
- 在 VS Code 中設定 MCP：
在 VS Code 的設定檔中加入：
{
"mcpServers": {
"fubon-mcp-server": {
"command": "/path/to/your/.venv/bin/python3",
"args": ["/path/to/your/server.py"],
"env": {
"FUBON_USERNAME": "您的富邦證券帳號",
"FUBON_PASSWORD": "您的富邦證券密碼",
"FUBON_PFX_PATH": "/path/to/your/certificate.pfx",
"FUBON_DATA_DIR": "/path/to/your/data/directory"
}
}
}
}
API 說明
取得歷史 K 線數據
historical_candles({
"symbol": "2330", # 股票代碼
"from_date": "2024-03-01", # 起始日期
"to_date": "2024-03-24" # 結束日期
})
查詢本地歷史數據
GET twstock://{symbol}/historical
注意事項
- 請妥善保管您的富邦證券帳號密碼和電子憑證
- 建議設定適當的數據快取目錄
- API 呼叫可能有每日次數限制
- 長時間區間的數據會自動分段請求
授權條款
MIT License
貢獻指南
歡迎提交 Issue 和 Pull Request
作者
Hans Li https://medium.com/@mingyawli
更新日誌
v0.1.0
- 初始版本發布
- 支援基本的歷史數據查詢
- 實作本地數據快取
Recommended Servers
Crypto Price & Market Analysis MCP Server
A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.
MCP PubMed Search
Server to search PubMed (PubMed is a free, online database that allows users to search for biomedical and life sciences literature). I have created on a day MCP came out but was on vacation, I saw someone post similar server in your DB, but figured to post mine.
dbt Semantic Layer MCP Server
A server that enables querying the dbt Semantic Layer through natural language conversations with Claude Desktop and other AI assistants, allowing users to discover metrics, create queries, analyze data, and visualize results.
mixpanel
Connect to your Mixpanel data. Query events, retention, and funnel data from Mixpanel analytics.
Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.
Nefino MCP Server
Provides large language models with access to news and information about renewable energy projects in Germany, allowing filtering by location, topic (solar, wind, hydrogen), and date range.
Vectorize
Vectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.
Mathematica Documentation MCP server
A server that provides access to Mathematica documentation through FastMCP, enabling users to retrieve function documentation and list package symbols from Wolfram Mathematica.
kb-mcp-server
An MCP server aimed to be portable, local, easy and convenient to support semantic/graph based retrieval of txtai "all in one" embeddings database. Any txtai embeddings db in tar.gz form can be loaded
Research MCP Server
The server functions as an MCP server to interact with Notion for retrieving and creating survey data, integrating with the Claude Desktop Client for conducting and reviewing surveys.