使用说明
Fathom MCP服务器
MCP（模型上下文协议）服务器，使LLM能够与 Fathom.video API用于会议记录管理、记录、摘要和分析。
特性
- 列出和筛选会议 -通过强大的过滤功能访问您的Fathom会议记录
- 获取成绩单和摘要 -检索人工智能生成的摘要和完整成绩单
- 团队管理 -列出组织中的团队和团队成员
- Webhook管理 -创建和删除用于实时通知的webhooks
- 搜索会议 -跨会议内容的全文搜索
- 分析 -获取会议统计数据和参与者见解
安装
# Clone or download the repository
git clone <repository-url>
cd fathom-mcp
# Install dependencies
npm install
# Build the project
npm run build
配置
获取您的Fathom API密钥
- 登录到 fathom：理解
- 前往“设置”>“API”
- 生成或复制API密钥
Claude桌面设置
将以下内容添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"fathom": {
"command": "node",
"args": ["/absolute/path/to/fathom-mcp/dist/index.js"],
"env": {
"FATHOM_API_KEY": "your-api-key-here"
}
}
}
}
环境变量
或者，设置环境变量：
export FATHOM_API_KEY=your-api-key-here
可用工具
核心API工具
| 工具 | 说明 |
|---|---|
fathom_list_meetings |
按日期、团队、域、记录者筛选列出会议 |
fathom_get_summary |
获取AI生成的录制摘要 |
fathom_get_transcript |
获取带有说话者身份的完整成绩单 |
fathom_list_teams |
列出您组织中的所有团队 |
fathom_list_team_members |
列出特定团队的成员 |
fathom_create_webhook |
创建用于会议通知的webhook |
fathom_delete_webhook |
删除现有的webhook |
辅助工具
| 工具 | 说明 |
|---|---|
fathom_search_meetings |
在会议标题、记录和摘要中搜索 |
fathom_meeting_stats |
获取分析：持续时间统计、团队细分、会议类型 |
fathom_participant_stats |
获取参与者频率和域分析 |
使用示例
列出最近的会议
"Show me my recent meetings"
获取会议摘要
"Get the summary for recording 123456789"
搜索会议
"Search my meetings for discussions about 'quarterly budget'"
按团队筛选
"List all Sales team meetings from last month"
获取分析
"Show me meeting statistics for this quarter"
创建Webhook
"Create a webhook to https://my-app.com/webhook for my recordings"
响应格式
所有工具都支持两种响应格式：
- 标记语言 （默认）：人类可读的格式化输出
- JSON：用于程序化处理的结构化数据
使用指定格式 response_format 参数。
速率限制
Fathom API的速率限制为每分钟60个请求。服务器优雅地处理速率限制，如果超过限制，将返回错误消息。
发展
# Install dependencies
npm install
# Development with auto-reload
npm run dev
# Build
npm run build
# Type checking
npm run typecheck
# Run the server
npm start
项目结构
fathom-mcp/
├── src/
│ ├── index.ts # Main entry point
│ ├── types.ts # TypeScript interfaces
│ ├── constants.ts # Configuration constants
│ ├── schemas/ # Zod validation schemas
│ ├── services/ # API client
│ └── tools/ # Tool implementations
├── dist/ # Compiled output
├── package.json
├── tsconfig.json
├── PRD.md # Project requirements
├── CHANGELOG.md # Version history
└── README.md
错误处理
服务器提供清晰、可操作的错误消息：
- 401：身份验证失败-请检查您的API密钥
- 404：找不到资源-验证录制ID
- 429：超出速率限制-请等待重试
- 网络错误：与Fathom API的连接问题
许可证
麻省理工学院
