AI导哈

会议信息检索服务

一个与Fathom AI会议API集成的MCP服务器，允许通过自然语言查询搜索和检索会议信息。

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

使用说明

MCP Fathom服务器

MCP（模型上下文协议）服务器，与Fathom AI的会议API集成，使Claude能够通过自然语言查询搜索和检索会议信息。

适用于 claude.ai （网络）， 克劳德桌面版 （app）和任何MCP兼容客户端。

特性

  • 智能搜索：跨会议标题、摘要和行动项进行自然语言搜索
  • 列出会议：使用筛选器检索会议（与会者、日期范围、团队、域等）
  • 成绩单支持：可选择包括完整的会议记录
  • 实时：与Fathom的API直接集成，以获取最新会议数据
  • 双模式：用作远程HTTP服务器（claude.ai）和本地stdio服务器（claude Desktop）

快速开始

有关详细的分步指南，请参阅 安装.md.

选项A：与claude.ai一起使用（推荐）

无需安装。服务器已部署并准备好使用。

  1. 获取您的Fathom API密钥首选 app.fathom.视频 → 设置→ API → 生成API密钥
  2. 将其添加到claude.ai首选 claude.ai → 设置→ 集成→ 添加MCP服务器
  3. 使用服务器URL https://mcp-fathom-server.vercel.app/api/mcp 并通过以下任一方式传递密钥：
    • Authorization: Bearer YOUR_FATHOM_API_KEY 头球 （首选——密钥不在URL和日志中），或
    • ?key=YOUR_FATHOM_API_KEY 查询参数 （传统，仍受支持）
  4. 开始提问 克劳德，关于你的会议！

如果标头和 ?key= 提供。

选项B：与Claude Desktop一起使用

  1. 克隆和构建：
git clone https://github.com/AleDeclerk/mcp-fathom-server.git
cd mcp-fathom-server
npm install
npm run build:stdio

  1. 得到你的 Fathom API密钥

  2. 添加到Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "fathom": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-fathom-server/dist/index.js"],
      "env": {
        "FATHOM_API_KEY": "your-api-key-here"
      }
    }
  }
}
  1. 重新启动克劳德桌面

使用示例

连接后，问克劳德自然语言问题：

"Show me my meetings from today"
"Find meetings about recruiting"
"List external meetings from last week"
"Search for meetings where we discussed product launches"
"List meetings with john@example.com"
"Find meetings with action items about hiring"
"What did we discuss in our Q1 planning meetings?"

可用工具

list_meetings

使用可选筛选器检索会议：

  • calendar_invitees --按与会者电子邮件筛选
  • calendar_invitees_domains --按公司域筛选
  • created_after / created_before --日期范围过滤器（ISO 8601）
  • meeting_type --全部、内部或外部
  • include_transcript --包括完整的成绩单
  • recorded_by --按会议所有者电子邮件筛选
  • teams --按团队名称筛选
  • limit --最大结果（默认值50）

search_meetings

按关键字在标题、摘要和行动项之间搜索会议：

  • search_term --要搜索的关键字/短语
  • include_transcript --在成绩单中搜索（默认情况下禁用性能）

默认搜索过去30天。

建筑

mcp-fathom-server/
├── app/api/mcp/route.ts      # HTTP MCP handler (claude.ai, Vercel)
├── lib/
│   ├── fathom-client.ts       # Fathom API client (shared)
│   └── types.ts               # TypeScript interfaces (shared)
├── src/
│   └── index.ts               # Stdio MCP handler (Claude Desktop)
├── next.config.ts             # Next.js config
├── tsconfig.json              # Next.js TypeScript config
├── tsconfig.stdio.json        # Stdio build TypeScript config
└── package.json

服务器有两个入口点：

  • 超文本传输协议 (app/api/mcp/route.ts)：用途 mcp-handler 用于流式HTTP传输。部署在Vercel上，用于claude.ai和支持远程服务器的任何MCP客户端。API密钥通过 Authorization: Bearer <key> 标题（首选）或 ?key=<key> 查询参数。
  • 工作室 (src/index.ts)：用途 StdioServerTransport 用于Claude Desktop的本地使用。API密钥是从 FATHOM_API_KEY 环境变量。

两者共享相同的Fathom API客户端(lib/fathom-client.ts).

自我寄宿

要部署自己的实例，您需要：

步骤：

  1. 分叉此仓库并克隆您的分叉：
    git clone https://github.com/YOUR_USERNAME/mcp-fathom-server.git
cd mcp-fathom-server
  2. 安装依赖项： npm install
  3. 安装Vercel CLI： npm i -g vercel
  4. 登录： vercel login
  5. 链接项目： vercel link
  6. 部署： vercel deploy --prod

您的MCP服务器URL将是：

https://your-project.vercel.app/api/mcp

每个用户在连接时都提供自己的Fathom API密钥-作为 Authorization: Bearer <key> 标题（首选）或作为 ?key=<key> 查询参数。密钥从不存储在服务器端。

发展

# HTTP server (Next.js dev)
npm run dev

# Stdio server (Claude Desktop)
npm run dev:stdio

# Build for production
npm run build          # Next.js (HTTP)
npm run build:stdio    # TypeScript (stdio)

# Test with MCP Inspector
npm test

故障排除

  • 服务器无法启动：检查一下 FATHOM_API_KEY 已设置（stdio模式）或 ?key= 处于URL（HTTP模式）
  • 未找到结果：尝试更广泛的搜索术语或检查您的API密钥是否具有正确的权限
  • 速率限制：Fathom限制API请求。请稍等，然后重试
  • 克劳德找不到工具：更改配置后重新启动Claude Desktop
  • “找不到方法”错误：更新到最新版本（添加了存根处理程序）

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

贡献

欢迎投稿！请随时提交拉取请求。

建造于 @阿勒德克勒克

相关 MCP