会议API集成服务器

MCP Fathom Server是一个用于Fathom AI会议API集成的模型上下文协议服务器,支持HTTP/SSE传输和Bearer Token认证。

  • by webloom-agency
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 webloom-agency/mcp-fathom-server

使用说明

MCP Fathom 服务器

一个用于Fathom AI会议的模型上下文协议(MCP)服务器,集成了API,支持HTTP/SSE传输和Bearer令牌认证。

特点

  • HTTP/SSE 传输通过HTTPS使用服务器发送事件(Server-Sent Events)进行访问
  • 承载令牌认证使用自定义承载令牌实现安全访问
  • Fathom AI 集成列出并搜索来自您Fathom账户的会议
  • Render.com 准备就绪优化为在Render.com上部署

环境变量

服务器需要以下环境变量:

  • FATHOM_API_KEY您的Fathom AI API密钥
  • MCP_BEARER_TOKEN用于认证的自定义承载令牌
  • PORT服务器端口(可选,默认为3000)

Render.com 部署

1. 创建一个新的网络服务

  1. 去你的(这里根据语境,可以理解为“去你的地方”或“去你自己的地方”,但直接翻译可能略显生硬,具体含义需结合上下文) 渲染仪表盘
  2. 点击“新建+”→“Web服务”
  3. 连接您的GitHub仓库

2. 配置构建设置

  • 构建命令: npm install && npm run build
  • 启动命令: npm start
  • 环境: Node

3. 设置环境变量

在您的渲染服务设置中,添加以下环境变量:

FATHOM_API_KEY=your_fathom_api_key_here
MCP_BEARER_TOKEN=your_secure_bearer_token_here
MCP_TIMEOUT=300000

4. 部署

点击“创建Web服务”并等待部署完成。

您的MCP服务器将在以下地址可用: https://your-app-name.onrender.com/sse

客户端配置

配置您的MCP客户端以连接到服务器:

{
  "mcpServers": {
    "fathom": {
      "url": "https://your-app-name.onrender.com/sse",
      "headers": {
        "Authorization": "Bearer your_secure_bearer_token_here"
      }
    }
  }
}

可用工具

搜索会议

全面搜索Fathom会议,支持高级过滤和丰富的数据检索功能。可按标题、摘要、行动项或参会者中的关键词进行搜索。自动排除执行团队和个人团队。

参数:

  • search_term (必填):在会议标题、摘要、行动项目或参会者姓名中搜索的关键词
  • limit (可选):要返回的会议最大数量(默认:50,最大:100)
  • days_back (可选):从今天起往前追溯的天数(默认:180天,最大:365天)
  • created_after (可选):过滤在此日期之后创建的会议(ISO 8601 格式)。如果提供,则覆盖 days_back 设置。
  • created_before (可选):筛选在此日期之前创建的会议(ISO 8601 格式)
  • exclude_teams (可选):从结果中排除的团队(默认:['高管', '个人'])
  • include_transcript (可选):是否包含完整转录文本(默认:否,警告:文件可能非常大且加载缓慢)
  • include_summary (可选):是否包含会议摘要(默认:true)
  • include_action_items (可选):是否包含行动项(默认:true)
  • calendar_invitees (可选):按参会者电子邮件地址筛选
  • calendar_invitees_domains (可选):按公司域名过滤
  • recorded_by (可选):按会议所有者电子邮件地址筛选

特点:

  • ✅ 全面搜索 跨标题、摘要、行动项、参会人员和会议记录
  • ✅ 丰富的数据检索 默认包含摘要和行动项
  • ✅(对号,表示正确、确认或完成) 智能团队筛选 自动排除执行会议和个人会议
  • ✅ 灵活的日期筛选 在过去几天或特定日期范围内
  • ✅ 高API限制 (最多100场会议)以提高搜索覆盖范围

API 端点

  • GET /sse - MCP 服务器发送事件端点(需要承载令牌)
  • GET /health - 健康检查端点(无需认证)

安全

  • 所有MCP终端点均需要承载令牌认证
  • 在生产环境中使用一个强大且唯一的承载令牌
  • 健康检查端点对所有人公开,用于监控目的

发展

本地开发

  1. 安装依赖项:

    npm install
    
  2. 设置环境变量:

    export FATHOM_API_KEY=your_fathom_api_key
    export MCP_BEARER_TOKEN=your_bearer_token
    
  3. 构建并运行:

    npm run build
    npm start
    
  4. 测试连接:

    curl -H "Authorization: Bearer your_bearer_token" http://localhost:3000/health
    

使用MCP Inspector进行测试

npm run test

许可证

麻省理工学院(MIT)