🔌 MCP 接入指南

通过 MCP（Model Context Protocol）协议，让 AI 客户端直接调用 API 工具

通用代码示例 前端界面参考 📡 API 接口文档 🧠 多模型聚合API 📦 Python SDK 🐘 PHP SDK 💳 购买KEY

🤖 什么是 MCP？

MCP（Model Context Protocol）是一种开放协议，允许 AI 客户端（如 Claude Desktop、Cursor 等）自动发现并调用您提供的 API 工具。 相比传统的 HTTP API，MCP 让 AI 能够理解每个工具的功能和参数，根据您的自然语言需求自动选择合适的工具并执行调用， 无需您手动编写 HTTP 请求代码。

简单说：配置一次 MCP 连接，AI 就能自动使用您的 14 个 API 工具，包括：AI数字人生成、语音合成、播客生成、图片/视频生成、文章创作、合约分析等全部功能。

⚙️ 连接配置

1. 获取 API Key

在 购买页面 选择套餐并支付后，您将获得一个 API Key（格式为 sk-xxx...xxx）。
已有 Key 的用户可直接使用，无需重新购买。

2. 配置 MCP 服务端地址

在您的 AI 客户端中，根据语言偏好选择以下 MCP 服务端地址：

中文版

https://www.ming.store/key/mcp/server.php

🌐 国际版 / International

https://www.ming.store/key/mcp/server_en.php

认证方式选择 Bearer Token 或 HTTP Header，填入您的 API Key。

3. 支持的 AI 客户端

任何支持 MCP 协议的客户端均可使用，包括但不限于：

  • Claude Desktop — Anthropic 官方桌面客户端
  • Cursor — 智能代码编辑器
  • Continue — 开源 AI 编码助手
  • 任意自定义客户端 — 支持 MCP 协议的 Python / Node.js / PHP 程序均可接入

4. 配置示例（以 Claude Desktop 为例）

在 Claude Desktop 的设置文件中添加以下配置：

{
  "mcpServers": {
    "xiaonan-web3": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-client"],
      "env": {
        "MCP_SERVER_URL": "https://www.ming.store/key/mcp/server.php",
        "MCP_API_KEY": "sk-你的API-Key"
      }
    }
  }
}

具体配置方式可能因客户端版本而异，请参照对应客户端的 MCP 配置文档。

🌐 International / 国际版 MCP 端点

如果您使用的是英文版 AI 客户端（如 Claude Desktop、Cursor 等），请使用以下国际版 MCP 端点。所有工具描述、参数说明均已翻译为英文，方便 AI 理解并正确调用。

https://www.ming.store/key/mcp/server_en.php

🇨🇳 中文用户请继续使用 https://www.ming.store/key/mcp/server.php

🛠️ 可用工具列表（共 23 个）

连接成功后，AI 客户端会自动获取以下工具列表。您只需用自然语言描述需求，AI 会自动选择合适的工具执行。

工具名功能说明
tts文本转语音：将文字转为 MP3 音频（支持 20+ 种音色）
podcast_submit播客提交：提交文本/链接，AI 生成双人对话播客
podcast_check播客查询：查询播客生成状态和音频链接
image_generate文生图：根据提示词生成图片，支持图生图
video_submit视频提交：根据提示词生成视频
video_check视频查询：查询视频生成进度和链接
article_generateAI 创作：根据关键词生成原创文章
video_parse视频解析：解析抖音/TikTok 无水印视频
market_analyze市场数据+AI：获取实时合约数据并生成分析报告
risk_analyze风控检查+AI：输入交易计划，生成风控评分和建议
token_analyze代币安全+AI：检测代币合约安全（蜜罐/税率等）
token_audit代币审计+AI：全面的链上合约安全审计
dexscreener_analyzeDEX 分析+AI：代币在 DEX 的交易对和流动性分析
extract_content网页内容提取：输入网页链接，返回干净的正文内容（每次消耗 1 次 KEY）
extract_summary网页摘要生成：提取网页内容后由小雨萝卜头生成摘要和关键词（每次消耗 3 次 KEY）
extract_social社交媒体监控：提取社交媒体帖子，识别平台和发布者，小雨萝卜头深度分析观点（每次消耗 5 次 KEY）
quota_checkKEY 配额查询：查询当前 API Key 的总次数、已使用次数和剩余可用次数（不消耗次数）
digital_human_submitAI数字人视频生成（ (OmniHuman1.5)提交）：输入文本+图片URL+音色，生成数字人播报视频（消耗50次）
digital_human_checkAI数字人视频生成（ (OmniHuman1.5)查询）：查询生成进度和视频链接（不消耗次数）
digital_human_volcv2_submitAI数字人视频生成（单图音频驱动V2 提交）：提交文本+图片URL+音色，先创建数字形象再生成口型同步视频，成本低速度快（消耗20次）
digital_human_volcv2_checkAI数字人视频生成（单图音频驱动V2 查询）：查询生成进度和视频链接（不消耗次数）
get_newsflash实时 Web3 快讯：获取 Odaily 星球日报实时快讯，支持 11 个分类筛选、关键词搜索和分页（每次消耗 1 次 KEY）
get_trump_feed特朗普动态追踪：获取特朗普在 Truth Social 和 Twitter/X 双平台的最新帖子和推文，包含互动数据，每次调用消耗 3 次 KEY

💬 调用示例

连接成功后，在 AI 客户端中直接用自然语言描述需求即可。例如：

示例 1："帮我分析一下 BTCUSDT 当前的市场数据，给出做多和做空的建议方案。"
→ AI 自动调用 market_analyze 工具，返回完整分析报告。

示例 2："检测一下这个代币合约 0x55d3... 在 BSC 链上的安全性。"
→ AI 自动调用 token_analyze 或 token_audit 工具，返回安全检测结果。

示例 3："帮我生成一段语音，内容是'你好，欢迎使用潇楠 Web3 哨兵'，用亲切女声。"
→ AI 自动调用 tts 工具，返回可直接播放的音频链接（有效期 24 小时）。

示例 4："查一下最近 AI 相关的快讯" 或 "搜索比特币的最新快讯"。
→ AI 自动调用 get_newsflash 工具，返回最新快讯列表。

示例 5："帮我看看特朗普最新的帖子和推文" 或 "获取特朗普在 Truth Social 上的最新动态"。
→ AI 自动调用 get_trump_feed 工具，返回双平台聚合数据。

⚠️ 注意事项

  • 扣减规则：通过 MCP 调用工具的扣减次数与直接调用 HTTP API 相同，详见 接口文档 中的扣减规则说明。
  • 调用频率限制：每个 API Key 的调用间隔至少为 500 毫秒，超出限制将被拒绝。
  • API Key 安全：请妥善保管您的 API Key，不要公开分享。所有扣减记录可在后台统计面板中查看。
  • 异步任务：播客和视频生成是异步任务，提交后需要轮询查询结果。AI 客户端会根据工具定义自动处理轮询逻辑。
  • 故障处理：如遇调用失败，AI 客户端会返回错误信息。常见错误包括配额不足、参数缺失、网络超时等。
HTTP API 文档 购买 API Key