MCP Fathom服务器
MCP（模型上下文协议）服务器，与Fathom AI的会议API集成，使Claude能够通过自然语言查询搜索和检索会议信息。
适用于 claude.ai （网络）， 克劳德桌面版 （app）和任何MCP兼容客户端。
特性
- 智能搜索：跨会议标题、摘要和行动项进行自然语言搜索
- 列出会议：使用筛选器检索会议（与会者、日期范围、团队、域等）
- 成绩单支持：可选择包括完整的会议记录
- 实时：与Fathom的API直接集成，以获取最新会议数据
- 双模式：用作远程HTTP服务器（claude.ai）和本地stdio服务器（claude Desktop）
快速开始
有关详细的分步指南，请参阅 安装.md.
选项A：与claude.ai一起使用（推荐）
无需安装。服务器已部署并准备好使用。
- 获取您的Fathom API密钥首选 app.fathom.视频 → 设置→ API → 生成API密钥
- 将其添加到claude.ai首选 claude.ai → 设置→ 集成→ 添加MCP服务器
- 使用服务器URL
https://mcp-fathom-server.vercel.app/api/mcp并通过以下任一方式传递密钥：
- Authorization: Bearer YOUR_FATHOM_API_KEY 头球 （首选——密钥不在URL和日志中），或 - ?key=YOUR_FATHOM_API_KEY 查询参数 （传统，仍受支持）
- 开始提问 克劳德，关于你的会议！
如果标头和 ?key= 提供。选项B：与Claude Desktop一起使用
- 克隆和构建：
git clone https://github.com/AleDeclerk/mcp-fathom-server.git
cd mcp-fathom-server
npm install
npm run build:stdio- 得到你的 Fathom API密钥
- 添加到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"
}
}
}
}- 重新启动克劳德桌面
使用示例
连接后，问克劳德自然语言问题：
"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=查询参数。 - 工作室 (
src/index.ts)：用途StdioServerTransport用于Claude Desktop的本地使用。API密钥是从FATHOM_API_KEY环境变量。
两者共享相同的Fathom API客户端(lib/fathom-client.ts).
自我寄宿
要部署自己的实例，您需要：
步骤：
- 分叉此仓库并克隆您的分叉：
git clone https://github.com/YOUR_USERNAME/mcp-fathom-server.git
cd mcp-fathom-server- 安装依赖项：
npm install - 安装Vercel CLI：
npm i -g vercel - 登录：
vercel login - 链接项目：
vercel link - 部署：
vercel deploy --prod
您的MCP服务器URL将是：
https://your-project.vercel.app/api/mcp每个用户在连接时都提供自己的Fathom API密钥-作为 Authorization: Bearer 标题（首选）或作为 ?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许可证-请参阅 许可证 文件以获取详细信息。
贡献
欢迎投稿！请随时提交拉取请求。
______________________________________________________________________
建造于 @阿勒德克勒克