/ 目录 / 演练场 / arcade-mcp
● 社区 ArcadeAI ⚡ 即开即用

arcade-mcp

作者 ArcadeAI · ArcadeAI/arcade-mcp

用于搭建、部署和分享 MCP 服务器的 Python 框架——内置 OAuth、密钥管理和一键客户端配置。

Arcade MCP (ArcadeAI) 是一个关注 MCP 服务器完整生命周期的 Python 框架:搭建(arcade new)、添加工具(包括 OAuth 集成)、部署到任何客户端。与 Golf 的区别在于强调分发——可以轻松与团队成员或用户分享服务器。

为什么要用

核心特性

实时演示

实际使用效果

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
步骤
  1. 安装 + 创建
    运行 uv tool install arcade-mcp,然后 arcade new my_server。打开生成的项目。✓ 已复制
    → 项目包含示例工具
  2. 本地运行
    运行 uv run server.py,使用 mcp tools(来自 f/mcptools)列出已发布的工具。✓ 已复制
    → 默认工具可见
  3. 配置 Claude Desktop
    运行 arcade configure claude 来接入。✓ 已复制
    → Claude Desktop 配置已更新;服务器在下次启动时出现

结果: 一个可用的 MCP,你可以迭代而不需要阅读规范文档。

搭配使用: mcptools

构建一个调用 OAuth 保护的 API 的 MCP 工具

👤 集成第三方 SaaS 的开发者 ⏱ ~45 min advanced

何时使用: 你需要 Claude 代表用户调用 Reddit/Linear/GitHub,而不是你的服务。

前置条件
  • 向目标提供商注册 OAuth 应用 — 提供商的开发者控制台
步骤
  1. 在 arcade.yaml 中配置 OAuth
    按照 arcade README 中的示例设置 Reddit OAuth。✓ 已复制
    → OAuth 提供商已注册
  2. 编写工具
    添加一个 get_saved_posts 工具,使用注入的 OAuth token 调用 Reddit 的 API。✓ 已复制
    → 用户授权后工具正常工作
  3. 首次运行触发授权
    从 Claude 调用 get_saved_posts——arcade 会让用户经历一次 OAuth 流程。✓ 已复制
    → Token 已存储;后续调用不会再次提示

结果: 用户级别的 MCP 集成,你无需保存凭据。

使用 Arcade 与团队分享一个 MCP 服务器

👤 平台 / 开发者体验团队 ⏱ ~20 min intermediate

何时使用: 你构建了一个方便的内部 MCP,想让其他人一键安装。

步骤
  1. 发布项目(内部注册表或 git)
    将你的 arcade 项目发布到内部 pypi 或标记的 GitHub release。✓ 已复制
    → 安装命令已准备好
  2. 团队成员安装
    团队成员运行 uvx <your-package>arcade configure claude ——完成。✓ 已复制
    → 服务器在他们的客户端中出现

结果: 新 MCP 在几分钟内被整个团队采用。

组合

与其他 MCP 搭配,撬动十倍杠杆

arcade + mcptools

在开发期间检查工具接口

对我的 arcade 开发服务器运行 mcp tools,在每次更改后验证 schema。✓ 已复制
arcade + hyper

比较相同工具的 Python/Arcade 和 WASM/hyper

在 Arcade 和 hyper-mcp 中实现相同的 'fetch_user' 工具;对延迟进行基准测试。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
arcade new <name> project_name: str 开始 0
arcade configure <client> client: claude|cursor|vscode 接入客户端 0
arcade dev 本地迭代 0

成本与限制

运行它的成本

API 配额
无——这是框架
每次调用 Token 数
取决于工具
费用
免费,开源
提示
为每个工具使用密钥作用域而不是全局环境变量——之后更容易审计

安全

权限、密钥、影响范围

凭据存储: Arcade 的密钥存储;OAuth token 与静态密钥分开存放
数据出站: 工具调用的任何地方

故障排查

常见错误与修复

安装后找不到 arcade 命令

确保 uv 的 tool bin 在 PATH 中:export PATH=$HOME/.local/share/uv/tools/bin:$PATH

验证: which arcade
OAuth 重定向循环

Callback URL 不匹配——必须完全匹配提供商注册的 URL,包括末尾斜杠

客户端中的工具 schema 没有刷新

大多数客户端会缓存;添加/删除工具后重启客户端

替代方案

arcade-mcp 对比其他方案

替代方案何时用它替代权衡
Golf你优先选择企业身份验证/遥测而不是分发人体工程学更以后端为导向
FastMCP单文件 MCP,不需要 OAuth自带除基础外的所有东西
TS SDK directTypeScript 技术栈不同的语言

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills