mcpField
F
Fubon MCP Server

Fubon MCP Server

本地服务
github.com/mingyaw金融数据283 周前更新
代码仓库

关于 Fubon MCP Server

Fubon MCP Server 通过富邦证券提供台股及 ETF 历史数据，并在本地缓存结果，按区间分段处理较长日期范围的请求。

主要功能

  1. 01查询股票及 ETF 历史 K 线
  2. 02本地缓存数据
  3. 03自动分段处理日期区间
  4. 04数据去重与排序
  5. 05计算成交值及价格变动

适用场景

  1. 01获取台股的历史 K 线
  2. 02查询本地缓存的历史数据
  3. 03分析指定日期范围内的价格变动

MCP 相关

该 MCP 服务提供历史 K 线查询工具，并通过 `twstock://{symbol}/historical` 资源访问本地保存的数据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

来自项目 README

Fubon MCP Server

富邦證券市場資料 MCP (Model Communication Protocol) 伺服器，用於獲取台股歷史數據。

功能特點

  • 支援台股及 ETF 歷史 K 線數據查詢
  • 本地數據快取，減少 API 呼叫次數
  • 自動分段處理長時間區間的數據請求
  • 支援數據去重和排序
  • 提供額外計算欄位（成交值、漲跌、漲跌幅）

系統需求

  • Python 3.8 或以上版本
  • 富邦證券電子憑證
  • macOS / Linux / Windows

安裝說明

  1. 克隆專案：
git clone https://github.com/yourusername/fubon-mcp-server.git
cd fubon-mcp-server
  1. 建立虛擬環境：
python3 -m venv .venv
source .venv/bin/activate  # macOS/Linux
# 或
.venv\Scripts\activate  # Windows
  1. 安裝相依套件：
pip install -r requirements.txt
  1. 設定環境變數：

將以下環境變數加入到 .env 檔案：

FUBON_USERNAME=您的富邦證券帳號
FUBON_PASSWORD=您的富邦證券密碼
FUBON_PFX_PATH=/path/to/your/certificate.pfx
FUBON_DATA_DIR=/path/to/your/data/directory

使用方法

  1. 啟動伺服器：
python server.py
  1. 在 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
  • 初始版本發布
  • 支援基本的歷史數據查詢
  • 實作本地數據快取

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。