arcade-mcp

用于构建MCP服务器和工具的开源Python框架。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:arcade-mcp。
它的用途是:用于构建MCP服务器和工具的开源Python框架。
完整的 Skill 内容见:https://321skill.com/skills/arcade-mcp/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我用Arcade MCP框架创建一个MCP服务器,里面添加一个能读取我GitHub仓库列表的工具。”,它会引导你安装CLI、初始化项目,并生成包含`@app.tool(requires_auth=GitHub(scopes=["repo"]))`装饰器的代码骨架,实现安全的OAuth工具调用。

介绍

Arcade MCP是一个专为构建Model Context Protocol(MCP)服务器和工具而设计的开源Python框架。它解决了开发者需要集成内部API、自定义OAuth认证或特定领域工具,但现有MCP工具库无法满足需求的问题。

通过简洁的装饰器API,开发者可以快速定义工具、资源和提示词。其核心亮点在于“授权工具调用”功能,开发者只需声明工具所需的OAuth作用域(如GitHub的repo),Arcade便会自动处理用户授权、令牌存储与刷新,并将令牌安全注入运行时环境,确保客户端和LLM都无法接触到敏感信息。

该框架非常适合需要将私有或定制化服务接入MCP生态的开发者,特别是智能体开发者、全栈开发者以及需要构建内部工具的产品团队。它支持所有主流MCP客户端、LLM和智能体框架,确保了良好的兼容性。

使用建议是,对于常见的OAuth提供商(如GitHub、Google、Notion等),可以直接使用内置的22个认证助手类;对于其他API,则可以使用通用的OAuth2类并在Arcade仪表板中注册应用。此外,它还提供了arcade evals用于测试工具调用准确性,以及arcade deploy用于一键部署到Arcade云。

核心特点

核心区别在于其内置的、开箱即用的OAuth授权管理机制,开发者无需自行处理复杂的OAuth流程、令牌刷新和安全管理,极大简化了构建需要用户授权的MCP工具的开发工作。同时,它提供了从开发、测试到部署的完整工具链。

注意事项

主要面向需要构建自定义MCP服务器的开发者,对于仅想使用现有MCP工具而非开发的普通用户来说并不直接适用。

常见问题

Arcade MCP和普通的MCP服务器开发有什么区别?

它提供了完整的OAuth授权、密钥管理、测试和部署工具链,大幅简化了开发流程,尤其是安全处理用户凭证的部分。

使用Arcade MCP需要付费吗?

框架本身是开源的,可以免费使用。其云部署和部分托管服务可能涉及费用,具体需查看Arcade.dev的定价。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/arcade-mcp/raw/index.md 读取 arcade-mcp 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。