docs(mcp): Claude Desktop 一鍵安裝擴充套件

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

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 檔），已補齊

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\<name>\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\<name>\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).
 

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)。