From ac087564b4176b31baf24e8442410d9af264ec68 Mon Sep 17 00:00:00 2001 From: linsamtw Date: Thu, 1 Oct 2026 18:28:12 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs(mcp):=20Claude=20Desktop=20=E4=B8=80?= =?UTF-8?q?=E9=8D=B5=E5=AE=89=E8=A3=9D=E6=93=B4=E5=85=85=E5=A5=97=E4=BB=B6?= =?UTF-8?q?=E3=80=81Windows=20=E6=8E=92=E6=9F=A5=E5=85=88=E5=BB=BA?= =?UTF-8?q?=E8=AD=B0=E9=87=8D=E9=96=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 修改檔案： - docs/tutor/ai/Mcp.md： - 安裝段新增 Claude Desktop 一鍵安裝（下載 finmind.mcpb 點兩下、貼 Token， 免裝 Python、免改設定檔），uv 改列為其他工具的前置步驟 - 「其他工具」清單移除 Claude Desktop（改註明可手動設定） - Windows tip 註明 Claude Desktop 不需要這些步驟；找不到指令時先建議 完全結束重開，仍不行再查完整路徑 - docs/tutor/ai/Mcp.en.md：同上英文版 Co-Authored-By: Claude Opus 5.5 --- docs/tutor/ai/Mcp.en.md | 10 ++++++---- docs/tutor/ai/Mcp.md | 10 ++++++---- 2 files changed, 12 insertions(+), 8 deletions(-) diff --git a/docs/tutor/ai/Mcp.en.md b/docs/tutor/ai/Mcp.en.md index b038e3a..187babd 100644 --- a/docs/tutor/ai/Mcp.en.md +++ b/docs/tutor/ai/Mcp.en.md @@ -8,7 +8,9 @@ If your AI tool supports [MCP (Model Context Protocol)](https://modelcontextprot ## Installation { #install } -First register at [FinMind](https://finmindtrade.com/analysis/#/account/register) to get a token, and install [uv](https://docs.astral.sh/uv/). +First register at [FinMind](https://finmindtrade.com/analysis/#/account/register) to get a token. + +**Claude Desktop (one-click, no Python or config editing needed):** download [finmind.mcpb](https://github.com/FinMind/FinMind-MCP/releases/latest/download/finmind.mcpb), double-click it, and paste your token in the install dialog. If double-clicking does nothing, open Claude Desktop → Settings → Extensions and drag the file into the window. **Claude Code (one-click):** first `export FINMIND_TOKEN=your_token_here`, then run inside Claude Code: @@ -19,7 +21,7 @@ First register at [FinMind](https://finmindtrade.com/analysis/#/account/register After install, run `/reload-plugins` to connect and `/mcp` to verify. (The plugin reads `${FINMIND_TOKEN}` from the environment, so export it before launching Claude Code.) -**Other tools (Claude Desktop / Cursor / Windsurf / Gemini CLI):** add this to the tool's MCP config file: +**Other tools (Cursor / Windsurf / Gemini CLI, or Claude Desktop if you prefer manual setup):** install [uv](https://docs.astral.sh/uv/) first, then add this to the tool's MCP config file: ```json { @@ -36,11 +38,11 @@ After install, run `/reload-plugins` to connect and `/mcp` to verify. (The plugi **Codex CLI** uses a different config format (`[mcp_servers]` in `~/.codex/config.toml`), or a one-liner: `codex mcp add finmind --env FINMIND_TOKEN=... -- uvx finmind-mcp`. !!! tip "Windows users" - The commands above use macOS / Linux syntax. On Windows, use **PowerShell** instead: + For Claude Desktop, the one-click install above is all you need. For other tools, the commands above use macOS / Linux syntax; on Windows, use **PowerShell** instead: - Install uv: `winget install --id astral-sh.uv -e` (close and reopen PowerShell afterwards so PATH takes effect), then verify with `uvx finmind-mcp --help`. - Set the token: `$env:FINMIND_TOKEN = "your_token_here"` (current window only) or `setx FINMIND_TOKEN "your_token_here"` (persistent; restart apps to pick it up) — or simply put it in the config file's `env` block above, which is the most reliable option. - - If your tool (e.g. Claude Desktop) reports the command not found or fails to connect: GUI apps see a different PATH than your terminal. Run `where.exe uvx` to find the full path (for a winget install, typically `C:\Users\\AppData\Local\Microsoft\WinGet\Links\uvx.exe`; use the first line it prints) and use it as `command` in the config. In JSON, write every backslash as `\\` (or use forward slashes `/`) — pasting single backslashes makes the config file invalid JSON. + - If your tool (e.g. Claude Desktop) reports the command not found or fails to connect: GUI apps see a different PATH than your terminal. First fully quit and reopen the tool — that usually fixes it. If not, run `where.exe uvx` to find the full path (for a winget install, typically `C:\Users\\AppData\Local\Microsoft\WinGet\Links\uvx.exe`; use the first line it prints) and use it as `command` in the config. In JSON, write every backslash as `\\` (or use forward slashes `/`) — pasting single backslashes makes the config file invalid JSON. For the full walkthrough (pipx route, per-host Windows config paths, troubleshooting), see the [Windows installation guide](https://github.com/FinMind/FinMind-MCP/blob/master/install/windows.md). diff --git a/docs/tutor/ai/Mcp.md b/docs/tutor/ai/Mcp.md index 1e7d1a9..cbce36a 100644 --- a/docs/tutor/ai/Mcp.md +++ b/docs/tutor/ai/Mcp.md @@ -8,7 +8,9 @@ ## 安裝 { #install } -請先至 [FinMind](https://finmindtrade.com/analysis/#/account/register) 註冊取得 Token，並安裝 [uv](https://docs.astral.sh/uv/)。 +請先至 [FinMind](https://finmindtrade.com/analysis/#/account/register) 註冊取得 Token。 + +**Claude Desktop（一鍵安裝，免裝 Python、免改設定檔）：** 下載 [finmind.mcpb](https://github.com/FinMind/FinMind-MCP/releases/latest/download/finmind.mcpb)，在檔案上點兩下，於安裝視窗貼上 Token 即可。若點兩下沒有反應，開啟 Claude Desktop「設定 → 擴充功能（Extensions）」，把檔案拖進視窗。 **Claude Code（一鍵安裝）：** 先 `export FINMIND_TOKEN=your_token_here`，再於 Claude Code 內輸入： @@ -19,7 +21,7 @@ 裝好後 `/reload-plugins` 連線、`/mcp` 確認。（plugin 讀環境變數 `${FINMIND_TOKEN}`，需在啟動 Claude Code 前先 export。） -**其他工具（Claude Desktop / Cursor / Windsurf / Gemini CLI）：** 在該工具的 MCP 設定檔加入： +**其他工具（Cursor / Windsurf / Gemini CLI，或想手動設定的 Claude Desktop）：** 先安裝 [uv](https://docs.astral.sh/uv/)，再於該工具的 MCP 設定檔加入： ```json { @@ -36,11 +38,11 @@ **Codex CLI** 的設定格式不同（用 `~/.codex/config.toml` 的 `[mcp_servers]`），或一行 `codex mcp add finmind --env FINMIND_TOKEN=... -- uvx finmind-mcp`。 !!! tip "Windows 使用者" - 上述指令以 macOS / Linux 為例，Windows 請改在 **PowerShell** 操作： + Claude Desktop 用上方一鍵安裝即可，不需要以下步驟。其他工具的指令以 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` 查出完整路徑（winget 安裝通常是 `C:\Users\<帳號>\AppData\Local\Microsoft\WinGet\Links\uvx.exe`，請以實際印出的第一行為準），填入設定檔的 `command`。JSON 中每個反斜線都要寫成 `\\`（或改用正斜線 `/`），直接貼上單一反斜線會讓設定檔變成不合法的 JSON。 + - 若工具（如 Claude Desktop）顯示找不到指令或連線失敗：圖形介面應用讀到的 PATH 和終端機不同。先把該工具**完全結束後重開**，多半就能解決；仍不行再用 `where.exe uvx` 查出完整路徑（winget 安裝通常是 `C:\Users\<帳號>\AppData\Local\Microsoft\WinGet\Links\uvx.exe`，請以實際印出的第一行為準），填入設定檔的 `command`。JSON 中每個反斜線都要寫成 `\\`（或改用正斜線 `/`），直接貼上單一反斜線會讓設定檔變成不合法的 JSON。 完整步驟（pipx 路線、各 host 的 Windows 設定檔路徑、常見問題）詳見 [Windows 安裝指引](https://github.com/FinMind/FinMind-MCP/blob/master/install/windows.md)。 From ef3f0080d7b0a40da10e51481b0a59e267d59521 Mon Sep 17 00:00:00 2001 From: linsamtw Date: Thu, 1 Oct 2026 19:03:08 +0800 Subject: [PATCH 2/2] =?UTF-8?q?WhatIsNew=202026-10-01=EF=BC=9AMCP=20Server?= =?UTF-8?q?=20=E6=96=B0=E5=A2=9E=20Claude=20Desktop=20=E4=B8=80=E9=8D=B5?= =?UTF-8?q?=E5=AE=89=E8=A3=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 修改檔案： - docs/WhatIsNew.md：2026-10-01 新增一行，MCP Server 支援 Claude Desktop 一鍵安裝（下載 finmind.mcpb 點兩下、貼 Token） - docs/WhatIsNew.en.md：同上英文版 Co-Authored-By: Claude Opus 5.5 --- docs/WhatIsNew.en.md | 1 + docs/WhatIsNew.md | 1 + 2 files changed, 2 insertions(+) diff --git a/docs/WhatIsNew.en.md b/docs/WhatIsNew.en.md index 8d6a645..faead0b 100644 --- a/docs/WhatIsNew.en.md +++ b/docs/WhatIsNew.en.md @@ -1,4 +1,5 @@ #### 2026-10-01 +* [MCP Server](https://finmind.github.io/en/tutor/ai/Mcp/#install) now supports one-click install for Claude Desktop: download finmind.mcpb, double-click it and paste your token, with no Python installation or config file editing needed. * **Data correction notice**: [Taiwan Stock Historical Tick Data Table TaiwanStockPriceTick](https://finmind.github.io/en/tutor/TaiwanMarket/Technical/#taiwan-stock-historical-tick-data-table-taiwanstockpricetick-available-only-to-backer-sponsor-members), [Taiwan Stock Minute K Table TaiwanStockKBar](https://finmind.github.io/en/tutor/TaiwanMarket/Technical/#taiwan-stock-minute-k-table-taiwanstockkbar-available-only-to-sponsor-members): the following issues have been corrected and the data regenerated. **If you downloaded or queried data for the dates below, please fetch it again** * **2019 ~ 2026**, emerging-market stocks: the duplicate-record handling for TWSE/TPEx closing auction and after-hours fixed-price trades was mistakenly applied to emerging-market stocks, so multiple trades with the same price and volume within the 13:30:00 and 14:30:00 seconds were kept as only one. In the minute K, 117 emerging-stock minutes (13:30, 14:30) had understated volume and have been regenerated; when querying emerging-stock ticks through the data API, some of the trades in these two seconds were missing, which has been fixed (Sponsor Pro whole-day download files were not affected) * **2019-01-02 ~ 2020-02-05** (242 trading days): the minute K was missing emerging-market stocks and some products such as ETNs (about 80 ~ 150 per day); these have been filled in diff --git a/docs/WhatIsNew.md b/docs/WhatIsNew.md index 35bcc27..e105d42 100644 --- a/docs/WhatIsNew.md +++ b/docs/WhatIsNew.md @@ -1,4 +1,5 @@ #### 2026-10-01 +* [MCP Server](https://finmind.github.io/tutor/ai/Mcp/#install) 新增 Claude Desktop 一鍵安裝：下載 finmind.mcpb 點兩下、貼上 Token 即可使用，不需安裝 Python 或編輯設定檔 * **資料校正公告**：[台灣股價歷史逐筆資料表 TaiwanStockPriceTick](https://finmind.github.io/tutor/TaiwanMarket/Technical/#taiwanstockpricetick-backersponsor)、[台股分 K 資料表 TaiwanStockKBar](https://finmind.github.io/tutor/TaiwanMarket/Technical/#k-taiwanstockkbar-sponsor)：以下問題已修正並重新產製。**曾下載或查詢過以下日期資料的使用者請重新取得資料** * **2019 ~ 2026** 興櫃股票：上市櫃收盤撮合、盤後定價的重複紀錄處理誤套用到興櫃，使 13:30:00、14:30:00 同一秒內相同價量的多筆成交只保留一筆。分 K 共 117 個興櫃股分鐘（13:30、14:30）成交量少算，已重新產製；透過資料 API 查詢興櫃逐筆時，這兩秒的多筆成交會少列，已修正（Sponsor Pro 整日下載檔未受影響） * **2019-01-02 ~ 2020-02-05**（242 個交易日）：分 K 缺少興櫃股票與部分 ETN 等商品（每日約 80 ~ 150 檔），已補齊