跳轉到

MCP Server

若你的 AI 工具支援 MCP（Model Context Protocol），可改用 FinMind 官方 MCP server finmind-mcp，由工具自動呼叫並實際抓取資料，不需手動下載 skill 檔。適合多輪、agentic 的查詢與分析。

其他串接方式

  • 網頁版 ChatGPT / Claude：用 llms.txt，免安裝。
  • CLI 工具想用指令檔：用 Agent Skill。

安裝

請先至 FinMind 註冊取得 Token，並安裝 uv。

Claude Code（一鍵安裝）： 先 export FINMIND_TOKEN=your_token_here，再於 Claude Code 內輸入：

/plugin marketplace add FinMind/FinMind-MCP
/plugin install finmind-mcp@finmind-official

裝好後 /reload-plugins 連線、/mcp 確認。（plugin 讀環境變數 ${FINMIND_TOKEN}，需在啟動 Claude Code 前先 export。）

其他工具（Claude Desktop / Cursor / Windsurf / Gemini CLI）： 在該工具的 MCP 設定檔加入：

{
  "mcpServers": {
    "finmind": {
      "command": "uvx",
      "args": ["finmind-mcp"],
      "env": { "FINMIND_TOKEN": "your_token_here" }
    }
  }
}

Codex CLI 的設定格式不同（用 ~/.codex/config.toml 的 [mcp_servers]），或一行 codex mcp add finmind --env FINMIND_TOKEN=... -- uvx finmind-mcp。

Windows 使用者

上述指令以 macOS / Linux 為例，Windows 請改在 PowerShell 操作：

  • 安裝 uv：winget install --id astral-sh.uv -e（裝完關閉 PowerShell 重開新視窗讓 PATH 生效），驗證 uvx finmind-mcp --help。
  • 設定 Token：$env:FINMIND_TOKEN = "your_token_here"（僅當前視窗）或 setx FINMIND_TOKEN "your_token_here"（永久，需重開程式生效）；也可直接填入上方設定檔的 env 區塊，最不易出錯。
  • 若工具（如 Claude Desktop）顯示找不到指令或連線失敗：圖形介面應用讀到的 PATH 和終端機不同，請用 where.exe uvx 查出完整路徑（通常是 C:\Users\<帳號>\.local\bin\uvx.exe），填入設定檔的 command；JSON 中反斜線要寫成 \\。

完整步驟（pipx 路線、各 host 的 Windows 設定檔路徑、常見問題）詳見 Windows 安裝指引。

各 host 的設定檔位置、claude mcp add / gemini mcp add / codex mcp add 指令與驗證方式，詳見 FinMind-MCP 安裝指南。

範例

MCP 由工具自動呼叫，直接用自然語言提問即可，不需要加 /finmind。最適合連續追問、跨資料集的 agentic 分析。

直接提問

台積電最近一個月股價走勢如何？

預期結果：工具自動呼叫 taiwan_stock_daily，回傳台積電（2330）近一個月每日股價並摘要走勢。

多輪追問

2330 三大法人近一週買賣超是多少？外資是偏買還是偏賣？
再幫我跟 2317 做同期比較。

預期結果：先回傳台積電三大法人買賣超並判讀外資方向，接著在同一對話延續查詢鴻海並對照，不需重新輸入條件。

跨資料集分析

幫我分析台積電近一年的股價報酬率，並對照同期的月營收成長趨勢，給我結論。

預期結果：工具分別抓取股價與月營收資料，計算報酬率與營收年增率，並綜合成一段分析結論。

條件篩選

今天三大法人買超金額最高的前 5 檔股票是哪些？

預期結果：工具查詢當日三大法人買賣資料，排序後回傳買超金額前 5 名的個股清單。

資料欄位注意事項

以下為 AI agent 判讀查詢結果時常見的欄位定義差異（台股股價、期貨逐筆），並非資料錯誤，請於分析時一併考量。

興櫃個股：open 為「前日均價」，可能落在當日高低之外（非資料錯誤）

興櫃股票採議價交易、沒有開盤價。因此本表對興櫃個股，open 欄填入的是 「前日均價」，而非當日開盤價；max / min / close 仍為當日最高 / 最低 / 最後成交價，皆正確可用。

所以興櫃個股在波動較大時，常出現 open 高於 max 或低於 min 的情形，這是欄位定義差異、非資料錯誤。畫 K 線時可改用 max / min / close，或將 open 視為前日均價處理。

範例：6515 穎崴 2020-03-19（當時為興櫃）→ open=218.06、max=200、min=170、close=174.9，其中 218.06 即當日的「前日均價」。該股後轉上市，上市後資料即正常。

期貨逐筆（TaiwanFuturesTick）成交量（volume）計量方式

逐筆成交量採「雙邊」計量：每一筆撮合成交會同時記錄買方與賣方各一次。因此將逐筆 volume 加總後，約為日成交資料 TaiwanFuturesDaily（單邊口數）的 2 倍；若為價差／組合單，因同時含兩個腳（leg），逐筆量約為日線的 4 倍。比對逐筆與日線成交量時，請依此換算。

期貨夜盤逐筆的交易日歸屬

夜盤（盤後交易）依期交所規則「以次一營業日為交易日」。某交易日 D 的夜盤（after_market），是指「前一營業日 15:00 起、至 D 當日 05:00 止」的那一段。 因此逐筆檔案中：

  • 00:00–05:00 的逐筆，歸屬於 TaiwanFuturesDaily 中交易日 D（當日）的夜盤（after_market）。
  • 08:45–13:45 的逐筆，歸屬於交易日 D 的一般交易時段（position）。
  • 15:00–24:00 的逐筆，屬於次一交易日的夜盤。