YCloud WhatsApp API MCP 服务器

English 中文

这是基于Model Context Protocol (MCP)构建的YCloud WhatsApp API服务器。它可以自动从YCloud WhatsApp OpenAPI规范生成工具，允许AI模型（如Claude）直接与YCloud WhatsApp API交互。

使用前提

在使用此服务器之前，您需要：

1. 在YCloud官方网站注册一个账户
2. 获取您的API密钥（请参阅以下说明）
3. 安装必要的软件依赖项（请参阅以下说明）

系统需求

• Node.js v16.0.0或更高版本
• Npm v7.0.0或更高版本
• Claude桌面应用程序（如果集成Claude）

功能

• 自动从OpenAPI规范生成MCP工具
• 支持所有YCloud API端点
• 支持API认证
• 自动处理参数类型和验证
• 支持HTTP请求和响应处理

安装

# 克隆仓库
git clone https://github.com/YCloud-Developers/ycloud-whatsapp-mcp-server.git
cd ycloud-whatsapp-m
npm install

# 构建项目
npm run build

使用说明

获取API密钥

要使用YCloud API，您需要一个用于身份验证的API密钥：

1. 登录到YCloud控制台
2. 导航到开发者页面
3. 在该页面上，您可以找到您的API密钥

API密钥应作为请求头X-API-Key包含在所有API请求中。

环境变量配置

您可以通过以下环境变量来配置服务器：

• API_BASE_URL: YCloud API的基础URL（默认： https://api.ycloud.com/v2 ）
• OPENAPI_SPEC_PATH: OpenAPI规范的路径或URL（默认： https://docs.ycloud.com/openapi.json ）
• API_HEADERS: API请求头（格式：key1: value1, key2: value2）

Claude桌面集成

要在Claude桌面应用中使用此服务器，请编辑Claude配置文件：

1. 查找或创建Claude桌面配置文件：

   • 在macOS上：~/Library/Application Support/Claude/claude_desktop_config.json
   • 在Windows上：%APPDATA%\Claude\claude_desktop_config.json

2. 添加以下配置：

{
  "mcpServers": {
    "ycloud-whatsapp": {
      "command": "node",
      "args": ["path/to/ycloud-whatsapp-mcp-server/build/index.js"],
      "env": {
        "API_BASE_URL": "https://api.ycloud.com/v2",
        "API_HEADERS": "X-API-Key:your-api-key-here"
      }
    }
  }
}

3. 替换your-api-key-here为您自己的YCloud API密钥

直接运行

# 设置环境变量并运行
API_BASE_URL=https://api.ycloud.com/v2 \
API_HEADERS="X-API-Key:your-api-key-here" \
npm start

示例

在Claude中，您可以使用以下提示与YCloud API进行交互：

请帮我查询我的YCloud账户余额。

Claude将能够调用适当的API端点并返回结果。

调试

在开发过程中，您可以使用以下方法调试MCP服务器：

1. 查看服务器日志：服务器将在运行时输出调试信息
2. 使用MCP Inspector：您可以使用MCP Inspector工具检查服务器的运行状态
3. Claude桌面调试：可以在Claude桌面应用程序中查看服务器状态和日志

贡献

欢迎提交Pull Request或创建Issue以改进本项目。

许可证

MIT