Archestra Logo
Star us on GitHub ⭐
Back to Catalog

ycloud-whatsapp-mcp-server

YCloud-Developers/ycloud-whatsapp-mcp-server
🔗 Latest commit:24ddf7c
🕒 Updated:Sep 9, 2025, 01:05 PM
TypeScript
AI Tools

MCP server from YCloud-Developers/ycloud-whatsapp-mcp-server

MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score39/100
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:6
👥 Contributors:1
📋 Total Issues:0
📦 Has Releases:No
🔧 Has CI/CD Pipeline:No
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
  "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"
    }
  },
  "ycloud-whatsapp-direct-run": {
    "command": "npm",
    "args": [
      "start"
    ],
    "env": {
      "API_BASE_URL": "https://api.ycloud.com/v2",
      "API_HEADERS": "X-API-Key:your-api-key-here"
    }
  }
}
MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:✓
Prompts:✗
Resources:✗
Sampling:✗
Roots:✗
Logging:✓
STDIO Transport:✓
HTTP Transport:✗
OAuth2 Auth:✗
Dependencies
6 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
Resources
GitHub Repository
Add Quality Badge
Show your MCP trust score in your README
Trust Score Badge
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/YCloud-Developers/ycloud-whatsapp-mcp-server)](https://archestra.ai/mcp-catalog/ycloud-developers__ycloud-whatsapp-mcp-server)
Edit This ServerAdd New MCP ServerReport an Issue
README.md

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-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

使用方法

获取API密钥

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

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

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

环境变量配置

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

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"
      }
    }
  }
}
  1. 替换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

ycloud-whatsapp-mcp-server MCP Server | Documentation & Integration | Archestra