Used as the runtime environment for the MCP server, allowing it to execute JavaScript code that interfaces with the YCloud WhatsApp API.
Used for package management and running scripts for the MCP server implementation.
Enables interaction with YCloud WhatsApp API, allowing sending messages, managing contacts, and accessing WhatsApp business features through the YCloud platform.
YCloud WhatsApp API MCP 服务器
English | 中文
这是一个基于Model Context Protocol (MCP)构建的YCloud WhatsApp API服务器。它能够自动从YCloud WhatsApp OpenAPI规范中生成工具,让AI模型(如Claude)可以直接与YCloud WhatsApp API交互。
前提条件
在使用此服务器之前,您需要:
- 在 YCloud官网 注册一个账户
- 获取您的API密钥(请参阅下面的说明)
- 安装必要的软件依赖(请参阅下面的说明)
系统要求
- Node.js v16.0.0 或更高版本
- npm v7.0.0 或更高版本
- Claude 桌面应用(如果要与 Claude 集成)
功能
- 自动从OpenAPI规范生成MCP工具
- 支持所有YCloud API端点
- 支持API认证
- 自动处理参数类型和验证
- 支持HTTP请求和响应处理
安装
使用方法
获取API密钥
要使用YCloud API,您需要一个API密钥进行身份验证:
- 登录到 YCloud控制台
- 导航到开发者页面
- 在此页面上,您可以找到您的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,key2)
Claude桌面端集成
要在Claude桌面应用中使用此服务器,请编辑Claude配置文件:
- 找到或创建Claude桌面配置文件:
- 在macOS上:
~/Library/Application Support/Claude/claude_desktop_config.json
- 在Windows上:
%APPDATA%\Claude\claude_desktop_config.json
- 在macOS上:
- 添加以下配置:
- 替换
your-api-key-here
为您的YCloud API密钥
直接运行
示例
在Claude中,您可以使用以下提示来与YCloud API交互:
Claude将能够调用适当的API端点并返回结果。
调试
在开发过程中,您可以使用以下方法调试MCP服务器:
- 查看服务器日志:服务器运行时会输出调试信息
- 使用MCP Inspector:您可以使用MCP Inspector工具来检查服务器的运行状态
- Claude桌面端调试:在Claude桌面应用中可以查看服务器状态和日志
贡献
欢迎提交Pull Request或创建Issue来改进此项目。
许可证
MIT
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A server that enables AI models like Claude to directly interact with YCloud WhatsApp API through natural language, automatically generating tools from the OpenAPI specification.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that allows Claude to make API requests on your behalf, providing tools for testing various APIs including HTTP requests and OpenAI integrations without sharing your API keys in the chat.Last updated -Python
- AsecurityAlicenseAqualityA Python server that enables language models like Claude to interact with WhatsApp Business API through GreenAPI, supporting features like sending messages and managing groups.Last updated -515PythonMIT License
- -securityAlicense-qualityA server that enables AI assistants like Claude to safely run Python code and access websites, processing data for better AI understanding while providing helpful error messages.Last updated -3PythonGPL 3.0
- -securityAlicense-qualityA bridge that connects WhatsApp Web to AI models using the Model Context Protocol, enabling Claude and other AI systems to interact with WhatsApp through a standardized interface.Last updated -256TypeScriptMIT License