跳到正文
RunAPI 开发者文档
EN 中文
开发者资源
开发者资源

Local MCP

通过 Claude Code、Cursor、VS Code、Windsurf 或其他 stdio 客户端在本机运行 RunAPI MCP Server。

查看 Markdown

Local MCP 让 MCP 客户端在你的电脑上启动 RunAPI MCP Server。仅当客户端不支持 Remote MCP，或你明确需要本机进程时使用。

开始之前

安装 Node.js，并确认可以使用 npx。你的 MCP 客户端必须支持本机 stdio server。

下列客户端都启动同一个命令：

SHELL 
npx -y @runapi.ai/mcp

无需登录即可完成连接并使用 catalog tools。

Claude Code

运行：

SHELL 
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

使用 -s user 可以在你的所有项目中使用 RunAPI。如果 Claude Code 已经在运行，请重启，然后确认 RunAPI 已列为 MCP server。

Cursor

在 .cursor/mcp.json 或 user MCP configuration 的 mcpServers 下添加 server：

JSON 
{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/mcp"]
    }
  }
}

在 Cursor sidebar 中打开 Customize，找到并启用 RunAPI。如果进程没有启动，请打开 Output 面板并选择 MCP Logs。

VS Code

  1. 打开 Command Palette，运行 MCP: Add Server。
  2. 选择 Command (stdio)，输入 npx -y @runapi.ai/mcp。
  3. 将 server 命名为 RunAPI，选择配置范围，然后启动。
  4. 根据提示信任该 server。遇到错误时，运行 MCP: List Servers，选择 RunAPI，然后选择 Show Output。

VS Code 的手动配置使用顶层 servers key 和 type: "stdio"。

Windsurf

以下步骤适用于 Cascade agent。Devin Local 使用 Devin CLI 配置。

  1. 打开 Devin Settings > Cascade > MCP Servers。
  2. 打开 raw MCP configuration：~/.codeium/windsurf/mcp_config.json。
  3. 使用上方 Cursor 示例中的 npx command 和 arguments 添加 RunAPI。
  4. 保存文件，刷新 MCP servers，然后启用 RunAPI。

其他 MCP 客户端

添加名为 RunAPI 的本机 stdio server。将 command 设为 npx，arguments 设为 -y 和 @runapi.ai/mcp。保存后重启或刷新客户端。

验证连接

向客户端提问：

RunAPI 有哪些可用的图片模型？

客户端应调用 list_models 并返回可用的图片模型。这个公开 discovery tool 不需要认证。

需要时再登录

无需登录即可继续使用 discovery tools。当你第一次要求 RunAPI 创建任务、查询任务或检查余额时，让客户端调用 login tool。它会在浏览器中打开 RunAPI，并将 credential 保存到共享的本机配置。

如果你更喜欢从 terminal 登录，请安装 RunAPI CLI 并运行：

SHELL 
runapi login

对于 headless 或 CI 客户端，请按照身份验证指南创建专用的 standard API key，再通过客户端的 environment 或 secret configuration 将它作为 RUNAPI_API_KEY 提供。Environment key 的优先级高于 Local MCP Login 保存的 credential。

排查问题

  • 找不到 npx：确认 node --version 和 npx --version 可以运行，然后完全重启 MCP 客户端，使其获取更新后的 environment。
  • 本机 server 立即退出：在 terminal 中运行 npx -y @runapi.ai/mcp，修正输出的 Node.js 或 package 错误，然后重启客户端。
  • RunAPI 工具没有出现：确认 server 已启用并使用 stdio，然后查看上方对应客户端的日志。
  • 需要认证的工具执行失败：让客户端调用 login tool。如果设置了 RUNAPI_API_KEY，请先更新或移除它，再重试 Local MCP Login。

希望连接时不运行本机 Node.js 进程？配置 Hosted MCP。