etfedge-mcp

MCP server for etfedge.xyz — 台灣主動 ETF 研究資料庫的 read-only 查詢介面。

Public MCP endpoint:

https://mcp.etfedge.xyz/mcp

在 Claude 裡使用

claude.ai（網頁版）

1. 開啟 claude.ai → 右上角頭像 → Settings

2. 側邊欄選 Integrations

3. 點 Add integration → 貼上 URL：

   https://mcp.etfedge.xyz/mcp

4. 儲存後，Claude 會引導你用 GitHub 帳號登入授權

Codex CLI

Codex 0.130+ 支援 streamable HTTP MCP server：

codex mcp add etfedge --url https://mcp.etfedge.xyz/mcp
codex mcp login etfedge
codex mcp list

或手動加入 ~/.codex/config.toml：

[mcp_servers.etfedge]
url = "https://mcp.etfedge.xyz/mcp"

完成 OAuth 後，codex mcp list 應顯示 etfedge 為 enabled 且 Auth 為 OAuth。已開啟的 Codex session 不會熱載入新 MCP；請重開 session 後使用。

Claude Code（CLI）

在專案根目錄的 .claude/settings.json（或全域 ~/.claude/settings.json）加入：

{
  "mcpServers": {
    "etfedge": {
      "type": "http",
      "url": "https://mcp.etfedge.xyz/mcp"
    }
  }
}

重啟 Claude Code 後輸入 /mcp 確認連線。

Claude Desktop

Claude Desktop 目前只支援本地 stdio 伺服器，需透過 mcp-remote 代理：

{
  "mcpServers": {
    "etfedge": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.etfedge.xyz/mcp"]
    }
  }
}

Config 路徑：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

• Windows：%APPDATA%\Claude\claude_desktop_config.json

Related MCP server: Schwab MCP Server

Tools

query_table 不提供 raw SQL。prices 必須帶 stock_code 或 trade_date filter，所有 table 查詢都限制在 allowlist 欄位且 limit 最高 500。

Auth

GitHub OAuth via fastmcp。連線時會引導 GitHub 登入，每個 GitHub 帳號 20 calls / 60 秒。

自架（Self-hosting）

pip install -e .
cp .env.example .env
# 填入 .env 後：
python mcp_server.py

See .env.example for required environment variables.