使用说明
项目简介
本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,它专注于与 Go High Level (GHL) 平台集成,实现子账户 API 密钥的自动化生成和管理。该服务器通过 MCP 协议,为 LLM 应用提供访问 GHL API 密钥的能力。
主要功能点
- 自动化 GHL 登录: 服务器能够自动登录到 Go High Level 平台。
- 子账户 API 密钥生成: 可以为 GHL 中的子账户自动生成 API 密钥。
- API 密钥数据库存储: 生成的 API 密钥会被安全地存储在数据库中。
- MCP 协议兼容: 完全遵循 MCP 协议规范,可以与任何 MCP 客户端进行交互。
安装步骤
- 克隆仓库:
git clone https://github.com/bpousa/ghl-mcp-integration.git cd ghl-mcp-integration - 安装依赖:
npm install - 配置环境变量:
- 复制 '.env.example' 文件并重命名为 '.env'。
- 根据 '.env' 文件中的说明,填写你的 GHL 平台凭据和其他必要的配置信息。
- 创建数据库:
- 使用 'src/database/schema.sql' 文件中的 SQL 脚本创建数据库和必要的表结构。你需要自行选择并配置数据库系统(例如 MySQL, PostgreSQL)。
- 启动服务器:
服务器启动成功后,会在控制台输出 "MCP server started successfully"。npm start
服务器配置 (MCP 客户端)
以下 JSON 配置信息用于 MCP 客户端连接到此 MCP 服务器。
{ "serverName": "ghl-mcp-server", // MCP 服务器名称,与 src/index.js 中定义的一致 "command": "npm", // 启动服务器的命令 "args": ["start"] // 启动命令的参数,这里表示执行 npm start }
配置参数说明:
- 'serverName': MCP 服务器的唯一标识名称。
- 'command': 用于启动 MCP 服务器的可执行命令,通常是 Node.js 环境下的 'npm' 或 'node'。
- 'args': 传递给 'command' 的参数数组,用于指定具体的启动命令,例如 'start' 脚本。
基本使用方法
- 连接 MCP 服务器: 在你的 MCP 客户端应用中,根据上述服务器配置信息连接到 'ghl-mcp-server'。
- 调用资源方法: 通过 MCP 客户端,你可以调用服务器提供的 'ghl-api-key' 资源的 'generateKey' 方法,并传入 'subAccountId' 作为参数,即可生成并获取指定子账户的 API 密钥。
- 例如,使用 MCP 客户端发送请求调用 'ghl-api-key.generateKey' 方法,并提供子账户 ID。
- 处理响应: MCP 服务器将返回 JSON-RPC 响应,其中包含生成的 API 密钥或错误信息。
信息
分类
商业系统