Gong MCP Server

Gong MCP 服务

一个 Model Context Protocol（MCP）服务，用于访问 Gong 的 API，以检索通话录音和转录文本。此服务允许 Claude 通过标准化接口与 Gong 数据交互。

功能

• 列出 Gong 通话，可选按日期范围筛选
• 检索指定通话的详细转录文本
• 使用 Gong API 凭据进行安全身份验证
• 提供标准化的 MCP 接口，便于与 Claude 集成

前置条件

• Node.js 18 或更高版本
• Docker（可选，用于容器化部署）
• Gong API 凭据（访问密钥和密钥）

安装

本地开发

1. 克隆仓库
2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

Docker

构建容器：

docker build -t gong-mcp .

配置 Claude

1. 打开 Claude Desktop 设置
2. 前往 MCP 服务部分
3. 使用以下配置添加新服务：

{
  "command": "docker",
  "args": [
    "run",
    "-it",
    "--rm",
    "gong-mcp"
  ],
  "env": {
    "GONG_ACCESS_KEY": "your_access_key_here",
    "GONG_ACCESS_SECRET": "your_access_secret_here"
  }
}

4. 将占位凭据替换为 .env 文件中的实际 Gong API 凭据

可用工具

列出通话

检索 Gong 通话列表，可选按日期范围筛选。

{
  name: "list_calls",
  description: "List Gong calls with optional date range filtering. Returns call details including ID, title, start/end times, participants, and duration.",
  inputSchema: {
    type: "object",
    properties: {
      fromDateTime: {
        type: "string",
        description: "Start date/time in ISO format (e.g. 2024-03-01T00:00:00Z)"
      },
      toDateTime: {
        type: "string",
        description: "End date/time in ISO format (e.g. 2024-03-31T23:59:59Z)"
      }
    }
  }
}

检索转录文本

检索指定通话 ID 的详细转录文本。

{
  name: "retrieve_transcripts",
  description: "Retrieve transcripts for specified call IDs. Returns detailed transcripts including speaker IDs, topics, and timestamped sentences.",
  inputSchema: {
    type: "object",
    properties: {
      callIds: {
        type: "array",
        items: { type: "string" },
        description: "Array of Gong call IDs to retrieve transcripts for"
      }
    },
    required: ["callIds"]
  }
}

许可证

MIT 许可证 — 详情请参阅 LICENSE 文件

贡献

1. Fork 仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request