> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 服务器总览

> 把 XHuoAPI 接入 Claude Desktop、Cursor、Windsurf 等支持 Model Context Protocol 的 AI 工具。

我们为每个核心服务提供官方 **MCP（Model Context Protocol）服务器**，让 Claude Desktop、Cursor、Windsurf、Continue 等支持 MCP 的 AI 工具直接调用 XHuoAPI API——不用再粘贴 cURL 命令，AI 助手会自动选择合适的接口、传参、解析返回。

## 什么时候用 MCP？

<CardGroup cols={2}>
  <Card title="✅ 在 IDE / 桌面 AI 里调用" icon="circle-check">
    你希望 Claude / Cursor 直接帮你生图、查搜索结果、转视频
  </Card>

  <Card title="✅ Agent / 工作流" icon="robot">
    在 AI Agent 编排里把 XHuoAPI 当工具集
  </Card>

  <Card title="❌ Web / 移动端业务" icon="circle-xmark">
    用 REST API 更稳定灵活
  </Card>

  <Card title="❌ 大规模生产推理" icon="circle-xmark">
    走 [api.xhuoapi.ai](https://api.xhuoapi.ai/v1) 直接调用
  </Card>
</CardGroup>

## 全部 MCP 服务器

<CardGroup cols={3}>
  <Card title="Midjourney" icon="image" href="/mcp/midjourney">
    AI 图像生成
  </Card>

  <Card title="Seedream" icon="image" href="/mcp/seedream">
    ByteDance 图像
  </Card>

  <Card title="Sora" icon="video" href="/mcp/sora">
    OpenAI 视频
  </Card>

  <Card title="Veo" icon="video" href="/mcp/veo">
    Google 视频
  </Card>

  <Card title="Luma" icon="video" href="/mcp/luma">
    Luma Dream Machine
  </Card>

  <Card title="Seedance" icon="video" href="/mcp/seedance">
    ByteDance 视频
  </Card>

  <Card title="Suno" icon="music" href="/mcp/suno">
    AI 音乐生成
  </Card>

  <Card title="Serp" icon="magnifying-glass" href="/mcp/serp">
    Google 网络搜索
  </Card>

  <Card title="ShortURL" icon="link" href="/mcp/shorturl">
    短链生成
  </Card>
</CardGroup>

## 准备工作

1. 准备一个 API Token（见 [网关与认证](/authentication)）
2. 安装 Python 3.10+（或用 `pipx` / `uvx`）
3. 选择目标 AI 工具的 MCP 配置文件

## Claude Desktop 配置

编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（Mac）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：

```json theme={null}
{
  "mcpServers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "XHuoAPI_API_TOKEN": "YOUR_API_TOKEN"
      }
    },
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_API_TOKEN": "YOUR_API_TOKEN"
      }
    },
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}
```

重启 Claude Desktop，输入框右下角会出现 🔌 图标——可用工具列表已加载完毕。

## Cursor / Windsurf 配置

在 Cursor `Settings` → `Tools & Integrations` → `Add new MCP server`，或编辑 `~/.cursor/mcp.json`：

```json theme={null}
{
  "mcpServers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "XHuoAPI_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}
```

Windsurf 同样支持 `mcp.json` 配置。

## HTTP 传输模式

每个 MCP 服务器都支持 `stdio` 和 `streamable-http` 两种传输：

```bash theme={null}
# stdio（默认，给桌面工具用）
uvx mcp-midjourney

# HTTP（给远程 / 多客户端）
uvx mcp-midjourney --transport streamable-http --host 0.0.0.0 --port 8000
```

HTTP 模式下 AI 客户端连接 `http://your-host:8000/mcp`。

## pip 安装

如果你不想用 `uvx`，可以用 pip：

```bash theme={null}
pip install mcp-midjourney mcp-suno mcp-serp
# 然后命令变成
{
  "command": "mcp-midjourney",
  "args": [],
  "env": { "XHuoAPI_API_TOKEN": "..." }
}
```

## 计费

调用 MCP 工具 = 调用 XHuoAPI API——**计费规则完全一样**。Token 在你的账号下扣费，MCP 服务器本身不收费。

详见 [价格总览](/pricing/overview)。

## 常见问题

* **AI 助手看不到工具**：检查 MCP 服务器日志（Claude Desktop 在 `~/Library/Logs/Claude/`），确认 Token 没拼错
* **`uvx` 命令找不到**：用 `pip install uv` 安装 `uv`，或直接换 `pip install`
* **HTTP 模式被拒**：检查防火墙、监听地址是 `0.0.0.0`（不是 `127.0.0.1`）
* **想用代理**：设置 `HTTPS_PROXY` 环境变量

## 相关文档

* [GitHub 源码 + 发布](https://github.com/XHuoAPI)
* [SunoMCP（PyPI）](https://pypi.org/project/mcp-suno/)
* [SerpMCP（PyPI）](https://pypi.org/project/mcp-serp/)