gong-mcp

# Gong MCP 服务器 Gong 模型上下文协议（MCP）服务器，提供访问 Gong API 以检索通话录音和文字记录的功能。该服务器允许 Claude 通过标准化的接口与 Gong 数据交互。 ## 功能特点 - 列出 Gong 通话，支持可选的日期范围筛选 - 检索特定通话的详细文字记录 - 使用 Gong API 凭证进行安全身份验证 - 标准化的 MCP 接口，便于与 Claude 集成 ## 前置条件 - Node.js 18 或更高版本 - Docker（可选，用于容器化部署） - Gong API 凭证（访问密钥和秘密密钥） ## 安装 ### 本地开发 1. 克隆仓库 2. 安装依赖： ```bash npm install ``` 3. 构建项目： ```bash npm run build ``` ### Docker 构建容器： ```bash docker build -t gong-mcp . ``` ## 配置 Claude 1. 打开 Claude Desktop 设置 2. 导航到 MCP 服务器部分 3. 添加新服务器，配置如下： ```json { "command": "docker", "args": [ "run", "-it", "--rm", "gong-mcp" ], "env": { "GONG_ACCESS_KEY": "您的访问密钥", "GONG_ACCESS_SECRET": "您的访问秘密密钥" } } ``` 4. 将占位符凭证替换为实际的 Gong API 凭证（来自您的 `.env` 文件） ## 可用工具 ### 列出通话 检索 Gong 通话列表，支持可选的日期范围筛选。 ```typescript { name: "list_calls", description: "列出 Gong 通话，支持可选的日期范围筛选。返回通话详情，包括 ID、标题、开始/结束时间、参与者、时长。", inputSchema: { type: "object", properties: { fromDateTime: { type: "string", description: "开始日期/时间，ISO 格式（例如 2024-03-01T00:00:00Z）" }, toDateTime: { type: "string", description: "结束日期/时间，ISO 格式（例如 2024-03-31T23:59:59Z）" } } } } ``` ### 检索文字记录 检索指定通话 ID 的详细文字记录。 ```typescript { name: "retrieve_transcripts", description: "检索指定通话 ID 的文字记录。返回详细文字记录，包括发言者 ID、主题、带时间戳的句子。", inputSchema: { type: "object", properties: { callIds: { type: "array", items: { type: "string" }, description: "要检索文字记录的 Gong 通话 ID 数组" } }, required: ["callIds"] } } ``` ## 许可证 MIT 许可证 - 参见 LICENSE 文件了解详情 ## 贡献 1. 分叉仓库 2. 创建功能分支（`git checkout -b feature/amazing-feature`） 3. 提交更改（`git commit -m 'Add some amazing feature'`） 4. 推送到分支（`git push origin feature/amazing-feature`） 5. 打开拉取请求