🚀 富邦證券市場資料 MCP 伺服器
富邦證券市場資料 MCP (Model Communication Protocol) 伺服器，主要用於獲取台股歷史數據。它能有效幫助使用者便捷地查詢相關信息，提升數據獲取效率。
🚀 快速開始
富邦證券市場資料 MCP 伺服器可助力您輕鬆獲取台股歷史數據。以下是使用前的準備步驟：
- 確保您的系統符合以下要求：
- Python 3.8 或以上版本
- 擁有富邦證券電子憑證
- 作業系統為 macOS / Linux / Windows
✨ 主要特性
- 支援台股及 ETF 歷史 K 線數據查詢，讓您全面掌握市場走勢。
- 本地數據快取功能，可減少 API 呼叫次數，提升查詢效率。
- 自動分段處理長時間區間的數據請求，避免大數據量請求的問題。
- 支援數據去重和排序，保證數據的準確性和整潔性。
- 提供額外計算欄位（成交值、漲跌、漲跌幅），為您提供更詳細的市場信息。
📦 安装指南
- 克隆專案：
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"
}
}
}
}
📚 详细文档
取得歷史 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
- 初始版本發布
- 支援基本的歷史數據查詢
- 實作本地數據快取