腾讯云HAI MCP服务器
这个项目实现了一个Model Context Protocol (MCP) 服务器，用于连接腾讯云HAI (Hunyuan AI) 服务。通过这个服务器，Claude Desktop/Cline可以直接调用腾讯云HAI的API。
功能特性
- 列出腾讯云HAI实例
- 获取特定HAI实例的详细信息
- 检查HAI实例的状态
- 根据状态筛选HAI实例
- 提供HAI实例信息作为资源
- 分析HAI实例配置并提供建议
安装方法
方法1：从GitHub克隆
- 克隆仓库
- 创建并激活虚拟环境
- 安装依赖
git clone https://github.com/avacx/hai-mcp-server.git
cd hai-mcp-server
python -m venv venv
source venv/bin/activate # 在Windows上使用 venv\Scripts\activate
pip install -r requirements.txt
方法2：通过pip安装
pip install hai-mcp-server
安装后可以通过命令行直接运行：
hai-mcp-server
方法3：使用Docker
docker pull avacx/hai-mcp-server:latest
docker run -e TENCENTCLOUD_SECRET_ID=你的SecretId -e TENCENTCLOUD_SECRET_KEY=你的SecretKey avacx/hai-mcp-server:latest
在Claude Desktop/Cline中安装
按照以下步骤在Claude Desktop/Cline中安装HAI MCP服务器：
创建目录 ：在/Users/你的用户名/Documents/Cline/MCP创建目录（Mac用户）或C:\Users\你的用户名\Documents\Cline\MCP（Windows用户）
克隆仓库 ：将GitHub仓库克隆到创建的目录中
cd /Users/你的用户名/Documents/Cline/MCP
git clone https://github.com/avacx/hai-mcp-server.git
cd hai-mcp-server
安装依赖 ：
python -m venv venv
source venv/bin/activate # 在Windows上使用 venv\Scripts\activate
pip install -r requirements.txt
配置环境变量 ：复制.env.example文件为.env并填入你的腾讯云API密钥
cp .env.example .env
编辑.env文件：
TENCENTCLOUD_SECRET_ID=你的SecretId
TENCENTCLOUD_SECRET_KEY=你的SecretKey
TENCENTCLOUD_REGION=ap-beijing
- 配置Claude Desktop/Cline ：
* 打开Claude Desktop/Cline设置文件：
* Mac: `/Users/你的用户名/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
* Windows: `C:\Users\你的用户名\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
* 添加HAI MCP服务器配置：
{
"mcpServers": {
"hai": {
"command": "/Users/你的用户名/Documents/Cline/MCP/hai-mcp-server/venv/bin/python",
"args": ["/Users/你的用户名/Documents/Cline/MCP/hai-mcp-server/run.py"],
"cwd": "/Users/你的用户名/Documents/Cline/MCP/hai-mcp-server",
"env": {
"PYTHONUNBUFFERED": "1",
"TENCENTCLOUD_SECRET_ID": "你的SecretId",
"TENCENTCLOUD_SECRET_KEY": "你的SecretKey",
"TENCENTCLOUD_REGION": "ap-beijing"
}
}
}
}
Windows用户请使用适当的路径格式：
{
"mcpServers": {
"hai": {
"command": "C:\\Users\\你的用户名\\Documents\\Cline\\MCP\\hai-mcp-server\\venv\\Scripts\\python.exe",
"args": ["C:\\Users\\你的用户名\\Documents\\Cline\\MCP\\hai-mcp-server\\run.py"],
"cwd": "C:\\Users\\你的用户名\\Documents\\Cline\\MCP\\hai-mcp-server",
"env": {
"PYTHONUNBUFFERED": "1",
"TENCENTCLOUD_SECRET_ID": "你的SecretId",
"TENCENTCLOUD_SECRET_KEY": "你的SecretKey",
"TENCENTCLOUD_REGION": "ap-beijing"
}
}
}
}
测试安装 ：重启Claude Desktop/Cline，然后使用以下提示测试MCP服务器：
请列出我的腾讯云HAI实例
配置
- 复制
.env.example文件为.env，并填入你的腾讯云API密钥：
cp .env.example .env
- 编辑
.env文件：
TENCENTCLOUD_SECRET_ID=你的SecretId
TENCENTCLOUD_SECRET_KEY=你的SecretKey
TENCENTCLOUD_REGION=ap-beijing
使用方法
直接运行
使用以下命令启动服务器：
python run.py
或者如果通过pip安装：
hai-mcp-server
命令行工具
查看版本信息：
hai-mcp-server version
启动服务器：
hai-mcp-server server --debug
列出HAI实例：
hai-mcp-server instances
获取特定实例详情：
hai-mcp-server instance 实例ID
项目结构
hai-mcp-server/
├── .env # 环境变量配置文件
├── .env.example # 环境变量示例文件
├── .gitignore # Git忽略文件
├── README.md # 项目说明文档
├── claude_desktop_config_example.json # Claude Desktop配置示例
├── requirements.txt # 项目依赖
├── run.py # 服务器启动脚本
├── setup.py # Python包配置文件
└── hai_mcp/ # 源代码目录
├── __init__.py # 包初始化文件
├── hai_client.py # 腾讯云HAI客户端
├── cli.py # 命令行入口点
└── server.py # MCP服务器实现
开发
构建Python包
pip install build twine
python -m build
构建Docker镜像
docker build -t hai-mcp-server:latest .
许可证
MIT
