MCP 集成指南

🔌什么是 MCP？

Model Context Protocol (MCP) 是由 Anthropic 推出的开放协议，允许 AI 助手（如 Claude）与外部工具和服务进行交互。 通过 MCP，你可以让 AI 助手直接调用 QT Pixel 的图像生成能力。

📋前置条件

1. Node.js 18+ - 下载安装
2. QT Pixel 账号 - 免费注册
3. API Key - 在 设置页面 获取
4. 支持 MCP 的 AI 客户端 - 如 Claude Desktop、Cursor 等

🤖Claude Desktop 配置

步骤 1: 找到配置文件

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

步骤 2: 添加 MCP 配置

{
  "mcpServers": {
    "qtpixel": {
      "command": "npx",
      "args": ["-y", "@qingchencloud/qtpixel-mcp"],
      "env": {
        "QTPIXEL_API_KEY": "gpa_your_api_key_here",
        "QTPIXEL_API_BASE": "https://pixel.qingchencloud.com"
      }
    }
  }
}

步骤 3: 重启 Claude Desktop

保存配置文件后，完全退出并重新打开 Claude Desktop。

📝Cursor IDE 配置

步骤 1: 创建配置文件

在你的项目根目录创建 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "qtpixel": {
      "command": "npx",
      "args": ["-y", "@qingchencloud/qtpixel-mcp"],
      "env": {
        "QTPIXEL_API_KEY": "gpa_your_api_key_here",
        "QTPIXEL_API_BASE": "https://pixel.qingchencloud.com"
      }
    }
  }
}

步骤 2: 重新加载 Cursor

保存文件后，重新打开 Cursor 或使用命令面板重新加载窗口。

🛠️可用工具

💬使用示例

❓常见问题