MCP Client Setup

MCP Client 設定

本專案預設以 stdio 連接桌面 MCP Host。Server 名稱為 fubon-api-mcp-server，目前支援 MCP protocol revision 2026-07-28。

VS Code Extension

Marketplace Extension ID：mofesto.fubon-api-mcp-server。

安裝後：

1. 開啟命令面板。
2. 執行 Fubon MCP: Configure Fubon MCP Server。
3. 輸入帳號、PFX 路徑與資料目錄。
4. 重新載入 VS Code。
5. 在 MCP 工具清單確認 fubon-api-mcp-server。

Extension 會建立使用者層級 mcp.json 並使用 VS Code inputs 提示敏感欄位。首次使用即使已安裝 Extension，仍建議執行一次 Configure，確保註冊資料存在。

VS Code 手動設定

Windows 使用者層級檔案通常位於：

%APPDATA%\Code\User\mcp.json

stdio 範例：

{
  "servers": {
    "fubon-api-mcp-server": {
      "type": "stdio",
      "command": "C:\\path\\to\\venv\\Scripts\\python.exe",
      "args": ["-m", "fubon_api_mcp_server.server"],
      "env": {
        "FUBON_USERNAME": "${input:fubon_username}",
        "FUBON_PASSWORD": "${input:fubon_password}",
        "FUBON_PFX_PATH": "${input:fubon_pfx_path}",
        "FUBON_PFX_PASSWORD": "${input:fubon_pfx_password}",
        "FUBON_DATA_DIR": "${input:fubon_data_dir}",
        "FUBON_MCP_TRANSPORT": "stdio"
      }
    }
  },
  "inputs": [
    {
      "id": "fubon_username",
      "type": "promptString",
      "description": "FUBON_USERNAME"
    },
    {
      "id": "fubon_password",
      "type": "promptString",
      "description": "FUBON_PASSWORD",
      "password": true
    },
    {
      "id": "fubon_pfx_path",
      "type": "promptString",
      "description": "FUBON_PFX_PATH"
    },
    {
      "id": "fubon_pfx_password",
      "type": "promptString",
      "description": "FUBON_PFX_PASSWORD",
      "password": true
    },
    {
      "id": "fubon_data_dir",
      "type": "promptString",
      "description": "FUBON_DATA_DIR"
    }
  ]
}

API-Key 使用者將 FUBON_PASSWORD 改為 FUBON_API_KEY 對應的安全 input；不要同時把秘密硬編碼在 JSON。

其他 stdio Host

不同 Host 的最外層 key 可能是 mcpServers 或其他名稱，但程序設定相同：

{
  "command": "python",
  "args": ["-m", "fubon_api_mcp_server.server"],
  "env": {
    "FUBON_USERNAME": "<INJECT_FROM_SECRET_STORE>",
    "FUBON_PASSWORD": "<INJECT_FROM_SECRET_STORE>",
    "FUBON_PFX_PATH": "<ABSOLUTE_PFX_PATH>",
    "FUBON_PFX_PASSWORD": "<INJECT_FROM_SECRET_STORE>",
    "FUBON_DATA_DIR": "<WRITABLE_DATA_DIRECTORY>",
    "FUBON_MCP_TRANSPORT": "stdio"
  }
}

請以該 Host 的官方文件確認配置 schema，不要直接把 VS Code 的 servers 包裝複製到其他 Client。

Streamable HTTP Client

Server endpoint 預設為 http://127.0.0.1:8000/mcp。MCP 2026-07-28 request 應包含：

• Content-Type: application/json
• 合適的 Accept
• MCP-Protocol-Version: 2026-07-28
• request _meta 中的 protocol version、client capabilities 與 client info

在 FUBON_MCP_STATELESS_HTTP=true 時，不應依賴 Mcp-Session-Id。

驗證 Client 連線

連線後應能 discovery 到 72 個 tools 與 12 個 prompts。先測試：

{
  "name": "get_intraday_quote",
  "arguments": {
    "args": {
      "symbol": "2330"
    }
  }
}

如果 Client 看得到 server 但看不到工具，先確認它支援目前 MCP revision，並查看 故障排除。