---
title: "RunAPI MCP Server — 210+ AI Models for Claude Code, Cursor & VS Code"
url: "https://runapi.ai/zh-TW/mcp.md"
canonical: "https://runapi.ai/zh-TW/mcp"
locale: "zh-TW"
---

# RunAPI MCP Server

把 Claude Code、Cursor、VS Code、Windsurf，以及任何相容 MCP 的 host 連接到 RunAPI — 不用離開編輯器，就能生成圖片、影片、音樂並呼叫 LLMs。

## What Is RunAPI MCP Server?

RunAPI MCP Server 會將相容 MCP 的開發工具連接到 RunAPI 平台。它讓你的 AI 助理可瀏覽 23 個 provider 的 210+ models、查看輸入參數、即時檢查價格、建立媒體生成任務、輪詢任務狀態、查看帳戶餘額，並呼叫 LLM endpoints——全部都能在編輯器內完成。探索工具不需要 API key。需驗證的操作則必須使用 RunAPI API key。

## Tools

| Tool | Auth | Purpose |
|---|---|---|
| list_models | No | Browse models by modality, service, or action. |
| get_model_info | No | Inspect input params, constraints, and pricing for a model. |
| list_actions | No | Group endpoint action names by output modality. |
| check_pricing | No | Return pricing snapshot for a service + action + model. |
| create_task | Yes | Create a media task and optionally poll until completion. |
| get_task | Yes | Fetch status and latest payload for an existing task. |
| check_balance | Yes | Return account balance and spending metrics. |
| chat | Yes | Send messages to a RunAPI LLM endpoint. |

## Quick Start

Choose the command for your MCP client.

### Claude Code

```bash
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
export RUNAPI_API_KEY="runapi_xxx"
claude
```

Use project scope when you want the repo to share `.mcp.json`:

```bash
claude mcp add runapi -s project -- npx -y @runapi.ai/mcp
```

### Codex

```bash
codex plugin install runapi-mcp@agents
export RUNAPI_API_KEY="runapi_xxx"
codex
```

### Cursor

```bash
npx @runapi.ai/mcp init cursor
export RUNAPI_API_KEY="runapi_xxx"
cursor .
```

### Windsurf

```bash
npx @runapi.ai/mcp init windsurf
export RUNAPI_API_KEY="runapi_xxx"
windsurf .
```

### VS Code

```bash
npx @runapi.ai/mcp init vscode
export RUNAPI_API_KEY="runapi_xxx"
code .
```

### Roo Code

```bash
npx @runapi.ai/mcp init roo
export RUNAPI_API_KEY="runapi_xxx"
code .
```

Free catalog tools work without a key.
Set `RUNAPI_API_KEY` for `create_task`, `check_balance`, and `chat`.
For GUI-launched clients, add the variable in the client's environment settings.

## Model Coverage

- **Image** — Flux Kontext, Nano Banana, GPT Image, Seedream, Ideogram, Qwen
- **Video** — Kling, Veo, Seedance, Hailuo, Wan, Runway, Luma
- **Music** — Suno v4 / v4.5 / v5 / v5.5
- **Audio** — ElevenLabs TTS, Sound Effects, STT, Isolation
- **LLM** — Claude, GPT, Gemini, DeepSeek

## FAQ

### 可以在 CI 或無頭環境中使用 MCP server 嗎？

可以。設定 RUNAPI_API_KEY 環境變數，並在你的 agent 或 CI pipeline 中設定 MCP server。server 會以 stdio process 執行，不需要瀏覽器或 GUI。

### MCP server 支援哪些程式開發工具？

RunAPI MCP Server 可搭配任何相容 MCP 的 host 使用：Claude Code、Codex、Cursor、VS Code（透過 GitHub Copilot）、Windsurf 和 Roo Code。也可設定給任何支援 MCP 協定的工具。


## Links

- [Model catalog](https://runapi.ai/zh-TW/models)
- [CLI](https://runapi.ai/zh-TW/cli)
- [SDKs](https://runapi.ai/zh-TW/sdk)
- [Skills](https://runapi.ai/zh-TW/skills)
- [Pricing](https://runapi.ai/zh-TW/pricing)
- [API docs](https://runapi.ai/zh-TW/docs)
- [GitHub](https://github.com/runapi-ai/mcp)
- [npm](https://www.npmjs.com/package/@runapi.ai/mcp)