---
title: Local MCP | RunAPI
description: 通过 Claude Code、Cursor、VS Code、Windsurf 或其他 stdio 客户端在本机运行 RunAPI MCP
  Server。
url: https://runapi.ai/zh-CN/docs/resources/mcp/local.md
canonical: https://runapi.ai/zh-CN/docs/resources/mcp/local
locale: zh-CN
---

> HTML version: https://runapi.ai/zh-CN/docs/resources/mcp/local
> Site index for agents: https://runapi.ai/llms.txt

# Local MCP

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](https://runapi.ai/zh-CN/docs/resources/cli) 并运行：

```shell
runapi login
```

对于 headless 或 CI 客户端，请按照[身份验证指南](https://runapi.ai/zh-CN/docs/guides/authentication)创建专用的
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](https://runapi.ai/zh-CN/docs/resources/mcp/hosted)。

---

## More from RunAPI

- [Home](https://runapi.ai/.md)
- [模型](https://runapi.ai/zh-CN/models.md)
- [AI 视频 API 对比](https://runapi.ai/zh-CN/ai-video-api-comparison.md)
- [OpenClaw 集成](https://runapi.ai/zh-CN/openclaw.md)
- [OpenClaw 最佳 API](https://runapi.ai/zh-CN/best-api-for-openclaw.md)
- [OpenClaw 图片生成](https://runapi.ai/zh-CN/openclaw-image-generation.md)
- [Hermes 智能体集成](https://runapi.ai/zh-CN/hermes-agent.md)
- [定价](https://runapi.ai/zh-CN/pricing.md)
- [Claude API 定价](https://runapi.ai/zh-CN/claude-api-pricing.md)
- [ChatGPT API 定价](https://runapi.ai/zh-CN/chatgpt-api-pricing.md)
- [OpenAI API 定价](https://runapi.ai/zh-CN/openai-api-pricing.md)
- [Gemini API 定价](https://runapi.ai/zh-CN/gemini-api-pricing.md)
- [Claude Code 定价](https://runapi.ai/zh-CN/claude-code-pricing.md)
- [Claude Code API](https://runapi.ai/zh-CN/claude-code-api.md)
- [Claude Code 对比 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md)
- [Claude Max 对比 API](https://runapi.ai/zh-CN/claude-max-vs-api.md)
- [Requesty 替代方案](https://runapi.ai/zh-CN/requesty-alternative.md)
- [文档](https://runapi.ai/zh-CN/docs/guides)
- [SDK](https://runapi.ai/zh-CN/sdk.md)
- [Skills](https://runapi.ai/zh-CN/skills.md)
- [MCP Server](https://runapi.ai/zh-CN/mcp.md)
- [CLI](https://runapi.ai/zh-CN/cli.md)
- [反馈](https://runapi.ai/)
- [联系](mailto:support@runapi.ai)
- [服务条款](https://runapi.ai/zh-CN/terms.md)
- [隐私政策](https://runapi.ai/zh-CN/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-CNicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "TechArticle",
    "headline": "Local MCP",
    "description": "通过 Claude Code、Cursor、VS Code、Windsurf 或其他 stdio 客户端在本机运行 RunAPI MCP Server。",
    "url": "https://runapi.ai/zh-CN/docs/resources/mcp/local",
    "mainEntityOfPage": "https://runapi.ai/zh-CN/docs/resources/mcp/local"
  }
]
```