具有GoHighLevel集成的MCP客户端
一个强大的 模型上下文协议（MCP）客户端 使用FastAPI构建，实现Claude AI和GoHighLevel CRM之间的无缝集成。该应用程序提供web界面和REST API，用于通过自然语言查询与GoHighLevel的253+工具交互。
🚀 特性
- 🤖 Claude AI集成：使用Anthropic的Claude 3.5 Haiku进行智能工具选择和执行
- 🔧 253+GoHighLevel工具：完全访问GoHighLevel的全面CRM工具包
- 🌐 web界面：用于自然语言查询的交互式聊天界面
- 📡 REST API：通过程序访问所有MCP工具和功能
- 🔄 实时通信：与GoHighLevel MCP服务器的实时连接
- 📊 健康监测：内置健康检查和状态监测
- 🛡️ 错误处理：通过用户友好的消息进行全面的错误处理
🛠️ 先决条件
- Python 3.11+
- Node.js和npm （适用于GoHighLevel MCP服务器）
- 无烟煤API密钥 (在这里买一个)
- GoHighLevel账户 具有API访问权限
⚡ 快速开始
1.克隆存储库
git clone https://github.com/yourusername/mcp-client-python.git
cd mcp-client-python2.安装依赖项
pip install -e .3.配置环境变量
创建一个 .env 根目录中的文件：
# MCP Client Configuration
# Anthropic API Key for Claude LLM
ANTHROPIC_API_KEY=your_anthropic_api_key_here
# GoHighLevel MCP Server Configuration
USE_GHL_SERVER=true
GHL_API_KEY=your_ghl_private_integration_token_here
GHL_LOCATION_ID=your_ghl_location_id_here
GHL_BASE_URL=https://services.leadconnectorhq.com4.启动应用程序
cd api
python3 -m uvicorn main:app --reload --host 0.0.0.0 --port 80005.访问应用程序
- web界面: http://localhost:8000
- API文档: http://localhost:8000/docs
- 健康检查: http://localhost:8000/health
🔧 配置
GoHighLevel设置
- 获取私有集成令牌:
- 转到GoHighLevel设置→ 集成 - 创建新的私有集成 - 复制私有集成令牌（以开头 pit-)
- 查找位置ID:
- 在GoHighLevel中，转到设置→ 公司设置 - 从URL或设置中复制您的位置ID
- 更新环境变量:
GHL_API_KEY=pit-your-private-integration-token
GHL_LOCATION_ID=your-location-id拟人克劳德设置
- 获取API密钥:
- 访问 Anthropic 控制台 - 创建帐户并获取您的API密钥 - 向您的帐户添加积分
- 更新环境变量:
ANTHROPIC_API_KEY=sk-ant-api03-your-api-key📖 用法
web界面
- 打开http://localhost:8000在浏览器中
- 键入自然语言查询，如：
- “显示本周创建的所有联系人” - “为John Doe创建新联系人” - “列出所有活动” - “获取上个月的分析”
REST API
处理自然语言查询
curl -X POST "http://localhost:8000/query" \
-H "Content-Type: application/json" \
-d '{"query": "Show me all contacts from this week"}'直接调用工具
curl -X POST "http://localhost:8000/tools/call" \
-H "Content-Type: application/json" \
-d '{"name": "contacts_list", "args": {"limit": 10}}'获取可用工具
curl "http://localhost:8000/tools"健康检查
curl "http://localhost:8000/health"🏗️ 建筑
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Web Client │───▶│ FastAPI Server │───▶│ Claude AI API │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│
▼
┌─────────────────┐
│ GoHighLevel MCP │
│ Server │
└─────────────────┘
│
▼
┌─────────────────┐
│ GoHighLevel API │
│ (253+ Tools) │
└─────────────────┘📁 项目结构
mcp-client-python/
├── api/
│ ├── main.py # FastAPI application
│ ├── mcp_client.py # MCP client implementation
│ ├── utils/
│ │ └── logger.py # Logging utilities
│ ├── templates/
│ │ └── chat.html # Web interface
│ └── static/ # Static assets
├── conversations/ # Chat logs (auto-generated)
├── .env # Environment variables
├── pyproject.toml # Project dependencies
└── README.md # This file🔍 可用的GoHighLevel工具
MCP服务器提供对253+GoHighLevel工具的访问，包括：
- 👥 联系人管理：创建、更新、搜索和管理联系人
- 📧 电子邮件营销：发送电子邮件、管理活动、跟踪打开/点击
- 📱 短信/彩信：发送短信、管理对话
- 📞 呼叫管理：拨打电话、跟踪通话记录、语音邮件
- 🎯 营销自动化：工作流程、触发器、活动
- 💰 销售渠道：机会、交易、销售跟踪
- 📊 分析和报告：绩效指标、转化跟踪
- 🗓️ 日历和约会：调度、可用性管理
- 💳 付款和发票：处理付款、管理发票
- 🏷️ 标签和自定义字段：组织和细分工具
🐛 故障排除
常见问题
- “需要ANTHROPIC_API_KEY环境变量”
- 确保您的 .env 文件位于根目录中 - 验证API密钥是否正确并且有足够的信用
- “令牌无权访问此位置”
- 验证您的位置ID是否正确 - 确保您的私有集成令牌具有适当的权限
- “无法连接到MCP服务器”
- 检查是否安装了Node.js和npm - 验证GoHighLevel凭据是否正确 - 检查互联网连接
调试模式
运行调试日志：
export LOG_LEVEL=DEBUG
python3 -m uvicorn main:app --reload🤝 贡献
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
- Anthropic 克劳德AI
- GoHighLevel 全面的CRM平台
- 模型上下文协议 通信标准
- 快速API 优秀的web框架
📞 支持
有关支持和问题：
- 在此存储库中创建问题
- 检查 GoHighLevel API文档
- 查看 人类API文件
______________________________________________________________________
⭐ 如果这个项目对你有帮助，请给它一颗星！