YCloud WhatsApp API MCP Server

YCloud WhatsApp API MCP Server

Bridge YCloud WhatsApp API to AI models via Model Context Protocol.

8
Stars
6
Forks
8
Watchers
3
Issues
YCloud WhatsApp API MCP Server enables seamless integration between the YCloud WhatsApp OpenAPI and AI models using the Model Context Protocol (MCP). It dynamically generates MCP tools from the OpenAPI specification, supporting interaction with all YCloud API endpoints. The server includes built-in handling for API authentication, parameter validation, and HTTP request/response management, and can be easily integrated with Claude desktop applications. Environment variable configuration allows flexible deployment and usage.

Key Features

Automatic MCP tool generation from OpenAPI specifications
Supports all YCloud WhatsApp API endpoints
API key-based authentication
Parameter type handling and validation
HTTP request and response management
Easy environment variable configuration
Seamless Claude desktop integration
Debugging support with server logs
MCP Inspector compatibility
MIT license and open contribution

Use Cases

Enabling AI models to interact with YCloud WhatsApp APIs
Automating WhatsApp messaging workflows through API agents
Integrating Claude with YCloud WhatsApp for contextual tasks
Generating API-based tools for agent frameworks
Providing standardized API context for conversational AI
Managing and monitoring YCloud API usage in AI platforms
Validating and testing MCP tool integration
Rapid prototyping of WhatsApp automation solutions
Supporting secure API interactions for AI systems
Building custom AI-driven customer engagement workflows

README

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请求和响应处理

安装

bash
# 克隆仓库
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请求中。

环境变量配置

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

  • 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. 添加以下配置:

json
{
  "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密钥

直接运行

bash
# 设置环境变量并运行
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

Star History

Star History Chart

Repository Owner

YCloud-Developers
YCloud-Developers

Organization

Repository Details

Language TypeScript
Default Branch main
Size 7,058 KB
MCP Verified Nov 11, 2025

Programming Languages

TypeScript
93.76%
JavaScript
6.24%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Make MCP Server (legacy)

    Make MCP Server (legacy)

    Enable AI assistants to utilize Make automation workflows as callable tools.

    Make MCP Server (legacy) provides a Model Context Protocol (MCP) server that connects AI assistants with Make scenarios configured for on-demand execution. It parses and exposes scenario parameters, allowing AI systems to invoke automation workflows and receive structured JSON outputs. The server supports secure integration through API keys and facilitates seamless communication between AI and Make's automation platform.

    • 142
    • MCP
    • integromat/make-mcp-server
  • OpenAI MCP Server

    OpenAI MCP Server

    Bridge between Claude and OpenAI models using the MCP protocol.

    OpenAI MCP Server enables direct querying of OpenAI language models from Claude via the Model Context Protocol (MCP). It provides a configurable Python server that exposes OpenAI APIs as MCP endpoints. The server is designed for seamless integration, requiring simple configuration updates and environment variable setup. Automated testing is supported to verify connectivity and response from the OpenAI API.

    • 77
    • MCP
    • pierrebrunelle/mcp-server-openai
  • youtube_mcp

    youtube_mcp

    YouTube transcription server with Model Context Protocol integration.

    youtube_mcp is a server that enables transcription of YouTube videos using the Model Context Protocol (MCP). Users can set up the server, authenticate via an MCP key, and stream video transcript data for integrated AI tools. Designed for use with applications like Claude desktop, it supports OpenAI APIs and utilizes browser cookies for access.

    • 26
    • MCP
    • format37/youtube_mcp
  • QuantConnect MCP Server

    QuantConnect MCP Server

    Official bridge for secure AI access to QuantConnect's algorithmic trading cloud platform

    QuantConnect MCP Server enables artificial intelligence systems such as Claude and OpenAI to interface with QuantConnect's cloud platform through an official, secure, and dockerized implementation of the Model Context Protocol (MCP). It facilitates automated project management, strategy writing, backtesting, and live deployment by exposing a comprehensive suite of API tools for users with valid access credentials. As the maintained official version, it ensures security, easy deployment, and cross-platform compatibility for advanced algorithmic trading automation.

    • 50
    • MCP
    • QuantConnect/mcp-server
  • Pica MCP Server

    Pica MCP Server

    A Model Context Protocol (MCP) server for seamless integration with 100+ platforms via Pica.

    Pica MCP Server provides a standardized Model Context Protocol (MCP) interface for interaction with a wide range of third-party services through Pica. It enables direct platform integrations, action execution, and intelligent intent detection while prioritizing secure environment variable management. The server also offers features such as code generation, form and data handling, and robust documentation for platform actions. It supports multiple deployment methods, including standalone, Docker, Vercel, and integration with tools like Claude Desktop and Cursor.

    • 8
    • MCP
    • picahq/mcp
  • MCP Server for Iaptic

    MCP Server for Iaptic

    A Model Context Protocol server for accessing and managing Iaptic data with AI agents.

    MCP Server for Iaptic implements the Model Context Protocol to enable AI models, such as Claude, to securely and efficiently interact with Iaptic's customer, purchase, transaction, and statistics data. The server provides a standardized interface and command set for querying and managing information related to customers, purchases, transactions, events, and application management. Designed for integration with Claude Desktop and similar AI clients, it offers both automated and manual installation options.

    • 5
    • MCP
    • iaptic/mcp-server-iaptic
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results