arcade-mcp MCP — 使用場景, 安裝 & 即時演示

為什麼要用

核心特性

arcade new 數秒內建立可運行的伺服器
內建 OAuth 支援第三方整合（Reddit 等）
依工具管理金鑰——不再有環境變數混亂問題
arcade configure 自動接入 Claude Desktop、Cursor、VS Code

即時演示

實際使用效果

arcade.replay ▶ 就緒

0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "arcade": {
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "arcade": {
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "arcade": {
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "arcade": {
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "arcade",
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "arcade": {
      "command": {
        "path": "uvx",
        "args": [
          "arcade-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add arcade -- uvx arcade-mcp

一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。

使用場景

實戰用法： arcade-mcp

用 Arcade 在 5 分鐘內建立可運行的 MCP 伺服器

👤 MCP 開發新手 ⏱ ~15 min beginner

何時使用： 你從未開發過 MCP，不想手動配置 SDK。

前置條件

uv — astral.sh/uv

步驟

安裝並建立專案

執行 uv tool install arcade-mcp，再執行 arcade new my_server，然後開啟產生的專案。✓ 已複製

→ 專案包含範例工具
在本地執行

執行 uv run server.py，並使用 mcp tools（來自 f/mcptools）列出已公開的工具。✓ 已複製

→ 預設工具可正常顯示
設定 Claude Desktop

執行 arcade configure claude 完成接入。✓ 已複製

→ Claude Desktop 設定已更新；下次啟動後伺服器出現

結果： 取得一個可持續迭代的 MCP，無需閱讀規格文件。

搭配使用： mcptools

建立可呼叫 OAuth 保護 API 的 MCP 工具

👤 整合第三方 SaaS 的開發者 ⏱ ~45 min advanced

何時使用： 你需要讓 Claude 以使用者身份呼叫 Reddit／Linear／GitHub，而非使用你自己的服務憑證。

前置條件

OAuth app registered with the target provider — Provider's dev console

步驟

在 arcade.yaml 中設定 OAuth

依照 arcade README 中的範例設定 Reddit OAuth。✓ 已複製

→ OAuth 提供者已完成註冊
撰寫工具

新增 get_saved_posts 工具，使用注入的 OAuth token 呼叫 Reddit API。✓ 已複製

→ 使用者授權後工具正常運作
首次執行觸發授權流程

從 Claude 呼叫 get_saved_posts——arcade 會引導使用者完成一次 OAuth 授權流程。✓ 已複製

→ Token 已儲存；後續呼叫不再重複提示

結果： 實現使用者範圍的 MCP 整合，無需由你持有使用者憑證。

組合

與其他 MCP 搭配，撬動十倍槓桿

arcade + mcptools

在開發期間檢查工具介面

每次修改後，對 arcade dev 伺服器執行 mcp tools 以驗證 schema 是否正確。✓ 已複製

arcade + hyper

比較 Python/Arcade 與 WASM/hyper 實作同一工具的差異

分別用 Arcade 和 hyper-mcp 實作相同的 'fetch_user' 工具，並比較兩者的延遲。✓ 已複製

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫
arcade new <name>	project_name: str	開始建立新專案時
arcade configure <client>	client: claude\|cursor\|vscode	將伺服器接入用戶端時
arcade dev		本地開發迭代時

成本與限制

運行它的成本

API 配額: 無——此為框架工具
每次呼叫 Token 數: 取決於各工具實作
費用: 免費，開放原始碼
提示: 依工具設定獨立的金鑰範圍，而非使用全域環境變數——日後稽核更方便

安全

權限、密鑰、影響範圍

憑證儲存： 使用 Arcade 的金鑰儲存庫；OAuth token 與靜態金鑰分開存放

資料出站： 取決於你的工具所呼叫的外部服務

故障排查

常見錯誤與修復

arcade command not found after install

確認 uv 的工具 bin 目錄已加入 PATH：export PATH=$HOME/.local/share/uv/tools/bin:$PATH

驗證： which arcade

OAuth redirect loop

Callback URL 不符——必須與提供者已註冊的 URL 完全一致，包含結尾斜線

Tool schema not refreshed in client

多數用戶端會快取工具資訊；新增或移除工具後請重新啟動用戶端

替代方案

arcade-mcp 對比其他方案

替代方案	何時用它替代	權衡
Golf	你更重視企業級驗證／遙測功能，而非發佈便利性	更偏向後端導向
FastMCP	只需單一檔案的 MCP，不需要 OAuth	基本功能以外的部分需自行實作
TS SDK direct	團隊以 TypeScript 為主要語言	不同語言生態

arcade-mcp

為什麼要用

核心特性

即時演示

實際使用效果

安裝

選擇你的客戶端

使用場景

實戰用法： arcade-mcp

用 Arcade 在 5 分鐘內建立可運行的 MCP 伺服器

前置條件

步驟

建立可呼叫 OAuth 保護 API 的 MCP 工具

前置條件

步驟

組合

與其他 MCP 搭配，撬動十倍槓桿

工具

此 MCP 暴露的能力

成本與限制

運行它的成本

安全

權限、密鑰、影響範圍

故障排查

常見錯誤與修復

替代方案

arcade-mcp 對比其他方案

更多

資源