使用说明

具有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-python

2.安装依赖项

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.com

4.启动应用程序

cd api
python3 -m uvicorn main:app --reload --host 0.0.0.0 --port 8000

5.访问应用程序

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文件

⭐ 如果这个项目对你有帮助，请给它一颗星！