跳转到主要内容

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（Model Context Protocol）服务器，让 Claude Desktop、Cursor、Windsurf、Continue 等支持 MCP 的 AI 工具直接调用 XHuoAPI API——不用再粘贴 cURL 命令，AI 助手会自动选择合适的接口、传参、解析返回。

​
什么时候用 MCP？

✅ 在 IDE / 桌面 AI 里调用

你希望 Claude / Cursor 直接帮你生图、查搜索结果、转视频

✅ Agent / 工作流

在 AI Agent 编排里把 XHuoAPI 当工具集

❌ Web / 移动端业务

用 REST API 更稳定灵活

❌ 大规模生产推理

走 api.xhuoapi.ai 直接调用

​
全部 MCP 服务器

Midjourney

AI 图像生成

Seedream

ByteDance 图像

Sora

OpenAI 视频

Veo

Google 视频

Luma

Luma Dream Machine

Seedance

ByteDance 视频

Suno

AI 音乐生成

Serp

Google 网络搜索

ShortURL

短链生成

​
准备工作

  1. 准备一个 API Token（见 网关与认证）
  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）： 
{
  "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： 
{
  "mcpServers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "XHuoAPI_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}
Windsurf 同样支持 mcp.json 配置。

​
HTTP 传输模式

每个 MCP 服务器都支持 stdio 和 streamable-http 两种传输： 
# 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： 
pip install mcp-midjourney mcp-suno mcp-serp
# 然后命令变成
{
  "command": "mcp-midjourney",
  "args": [],
  "env": { "XHuoAPI_API_TOKEN": "..." }
}

​
计费

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

​
常见问题

  • 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 环境变量

​
相关文档