Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,6 @@ pipx install finmind-mcp
|---|---|
| Claude Desktop | [install/claude-desktop.md](install/claude-desktop.md) |
| Claude Code | [install/claude-code.md](install/claude-code.md) |
| Claude.ai (Web) | [install/claude-ai.md](install/claude-ai.md) |
| Cursor | [install/cursor.md](install/cursor.md) |
| Windsurf | [install/windsurf.md](install/windsurf.md) |
| Gemini CLI | [install/gemini-cli.md](install/gemini-cli.md) |
Expand Down Expand Up @@ -81,7 +80,6 @@ git push origin v0.1.0 # → CI 自動 build + 發 PyPI
`knowledge/` 由 hatch `force-include` 打包進 wheel(`finmind_mcp/_knowledge/`),server runtime 直接讀、不用 compile;發版後用戶 `uvx finmind-mcp` / `pipx install finmind-mcp` 即抓到新版。

> 首次需在 PyPI 設好 trusted publisher(project `finmind-mcp` / repo `FinMind/FinMind-MCP` / workflow `publish.yml` / env `pypi`)。
> Remote endpoint `mcp.finmindtrade.com`(給 Claude.ai integrations)另走 service repo 的 docker compose + traefik,不在此 repo。

### Custom GPT(ChatGPT 線)— 產物自動 build、建 GPT 手動

Expand Down
2 changes: 1 addition & 1 deletion docs/mcp-original-readme.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# finmind-mcp

Official FinMind MCP server. Exposes the FinMind v4 API to MCP-compatible
AI tools (Claude Desktop / Code / Claude.ai, Gemini CLI, Cursor, Windsurf).
AI tools (Claude Desktop / Code, Gemini CLI, Cursor, Windsurf, Codex).

## Tools

Expand Down
36 changes: 0 additions & 36 deletions install/claude-ai.md

This file was deleted.

19 changes: 1 addition & 18 deletions knowledge/token-guide.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# FinMind Token 取得與設定

FinMind 所有 API 請求都需要 token;本文件說明如何取得,並在 ChatGPT Custom GPT
與各種 MCP host(Claude Desktop / Claude Code / Cursor / Windsurf / Gemini CLI / Claude.ai
與各種 MCP host(Claude Desktop / Claude Code / Cursor / Windsurf / Gemini CLI)
完成設定。

## 1. 取得 Token
Expand Down Expand Up @@ -79,20 +79,3 @@ uvx finmind-mcp --help # 用 uv 即時跑,不長駐安裝
驗證:重啟 host,輸入「列出 FinMind 可用的 dataset」,應出現 MCP 工具圖示並回覆
dataset 清單;若得到 `AuthenticationError`,請檢查環境變數是否正確設定且未含
多餘空白 / 引號。

### Remote 模式(Claude.ai integrations)

Remote 模式由官方 host `https://mcp.finmindtrade.com`(部署後啟用)提供,
Claude.ai 透過 HTTP / SSE 連線,使用 MCP 標準的 OAuth flow 取得授權:

1. Claude.ai → **Settings → Integrations → Add MCP server**
2. URL 填 `https://mcp.finmindtrade.com`(部署上線後提供,目前 placeholder)
3. 按 **Connect**,瀏覽器會跳到 finmindtrade.com OAuth 授權頁
4. 用既有帳號登入並按「允許」
5. Claude.ai 收到 access token 後完成註冊,之後直接在對話中觸發 FinMind 工具

Remote 模式下用戶**不需要**手動貼 token;授權後 token 由 Claude.ai 端管理,
撤銷請到 finmindtrade.com 會員中心 → 已授權應用 → 移除。

> 注意:remote endpoint 仍在部署中,正式 URL 上線後本檔案會同步更新。
> 在那之前,Claude.ai 用戶可改用 Claude Desktop 走 stdio 模式。
Loading