Fathom MCP 服务器

使用说明（Markdown 格式）

• 项目简介
  • 这是一个基于 MCP 的服务器端实现，设计用于把 Fathom 的会议、转录、摘要等数据通过 MCP 协议以统一、标准化的上下文服务形式暴露给大语言模型（LLM）客户端，并提供可扩展的工具执行能力、会话管理和 OAuth 集成。
• 主要功能点
  • MCP 协议支持：通过 Model Context Protocol 提供工具注册、执行与上下文渲染能力，供 LLM 客户端通过 MCP 调用。
  • 工具注册与执行：内置或可扩展的工具集合（如列出会议、获取转录、获取摘要、列出团队和成员等），LLM 调用时会返回结构化文本内容。
  • 会话与传输：实现会话管理、传输通道（如 Http/WS）以及对话上下文的持久化与清理。
  • 安全与认证：通过 Bearer Token 进行鉴权，集成细粒度的令牌、令牌轮换与令牌存储加密（AES-256-GCM）。
  • 服务器端对接：对接 Fathom API（通过授权服务获取访问令牌），并将数据转发给 Claude 等 MCP 客户端。
  • 自托管与自定义：提供自托管自服务部署、数据库迁移、开发与测试支持等。
• 安装步骤
  • 克隆代码并安装依赖。
  • 配置环境变量（数据库连接、加密密钥、Fathom 客户端信息、Claude 回调等）。
  • 构建后启动服务（通常通过 npm run build/ npm run start 的方式）。
  • 在 Claude/Bot 客户端配置中添加自定义连接地址，并进行身份认证以建立 MCP 会话。
• 服务器配置（MCP 客户端连接信息，JSON 格式，便于理解客户端需要的最小连接信息）
  • 服务器名称: fathom-mcp
  • 启动命令: node
  • 参数（示例）: dist/index.js
  • 工作目录: 应用根目录
  • 环境变量示例（请按实际部署填写）：BASE_URL、DATABASE_URL、TOKEN_ENCRYPTION_KEY、FATHOM_CLIENT_ID、FATHOM_CLIENT_SECRET、CLAUDE_AUTH_CALLBACK_URL
  • 注释说明：以上信息用于描述客户端如何启动并连接到 MCP 服务器，实际部署中客户端不需要暴露或依赖这些实现细节，只需按照示例配置在环境中提供相同的运行条件。
• 基本使用方法
  • 启动服务器后，确保蜂拥的依赖已就绪。
  • 在 Claude/LLM 客户端中将连接地址设为服务器的公开端点，例如 https://your-host/mcp。
  • 在客户端发起上下文请求时，使用 Bearer Token 进行鉴权，服务端会按 MCP 标准处理请求并返回 JSON-RPC 风格的结果。
  • 如需扩展工具集，可在服务端实现新的 ToolServer 注册逻辑，并通过 MCP 客户端调用。