使用说明
了解mcp
用于Fathom.video的MCP服务器 --直接从Cursor IDE访问您的AI会议记录、摘要和行动项
A. 模型上下文协议(MCP) 集成的服务器 Fathom.video 使用Cursor等AI编码助手。查询您的会议记录,将录音导出到markdown,按参与者搜索,以及管理webhooks——所有这些都是通过自然语言完成的。
特性
- 📋 列出和搜索会议 --使用日期、团队、参与者或外部域的筛选器浏览录制
- 📝 完整成绩单 --获取带有演讲者标签和时间戳的成绩单,格式为markdown
- 📊 AI摘要 --访问Fathom的人工智能生成的会议摘要
- ✅ 行动项 --从特定会议或最近的电话中提取行动项目
- 📁 导出到Markdown --将会议另存为
MeetingTitle_YYYY-MM-DD.md文件 - 👥 团队管理 --列出团队和团队成员
- 🔔 网络钩子 --创建和管理用于实时通知的Webhook
快速开始
1.获取您的Fathom API密钥
- 首选 父亲设置
- 导航至 API访问
- 点击 生成API密钥
2.安装MCP服务器
git clone https://github.com/matthewbergvinson/fathom-mcp.git
cd fathom-mcp
npm install
npm run build
3.配置光标
添加到您的 ~/.cursor/mcp.json:
{
"mcpServers": {
"fathom": {
"command": "node",
"args": ["/path/to/fathom-mcp/dist/index.js"],
"env": {
"FATHOM_API_KEY": "your-api-key-here",
"FATHOM_OUTPUT_DIR": "/path/to/export/transcripts"
}
}
}
}
注: 替换
/path/to/fathom-mcp使用克隆repo的实际路径,并添加Fathom API密钥。
4.重新启动游标
重新启动Cursor以加载MCP服务器。您现在可以使用自然语言与Fathom数据进行交互:
- “列出我最近5次父亲会议”
- “获取我与约翰通话的记录”
- “将昨天的会议导出为降价”
- “显示本周的行动项目”
可用工具
会议操作
| 工具 | 说明 |
|---|---|
list_meetings |
列出带过滤器的会议(日期、团队、仅限外部) |
get_meeting |
获取完整的会议详细信息,包括记录、摘要、行动 |
get_transcript |
只获取markdown格式的成绩单 |
search_meetings |
按参与者电子邮件、公司域或团队搜索 |
出口业务
| 工具 | 说明 |
|---|---|
export_meeting |
将单次会议导出到 MeetingTitle_YYYY-MM-DD.md |
export_all_meetings |
带有可选日期过滤器的批量导出会议 |
行动项
| 工具 | 说明 |
|---|---|
get_action_items |
从特定会议或最近的电话中获取行动项目 |
团队管理
| 工具 | 说明 |
|---|---|
list_teams |
列出您组织中的所有团队 |
list_team_members |
列出团队成员(可选择按团队筛选) |
网络钩子
| 工具 | 说明 |
|---|---|
create_webhook |
为新会议通知创建webhook |
delete_webhook |
删除现有的webhook |
刀具参数
list_meetings
| 参数 | 类型 | 说明 |
|---|---|---|
limit |
number | 要返回的最大会议数(0=全部) |
created_after |
string | ISO 8601时间戳过滤器 |
created_before |
string | ISO 8601时间戳过滤器 |
include_external_only |
boolean | 仅限与外部参与者的会议 |
get_meeting
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
recording_id |
number | 是 | 会议的录制ID |
include_transcript |
boolean | 否 | 包括成绩单(默认值:true) |
include_summary |
boolean | 否 | 包括AI摘要(默认值:true) |
include_action_items |
boolean | 否 | 包括操作项(默认值:true) |
include_crm_matches |
boolean | 否 | 包括CRM数据(默认值:true) |
search_meetings
| 参数 | 类型 | 说明 |
|---|---|---|
participant_emails |
string[] | 按参与者电子邮件筛选 |
domains |
string[] | 按公司域过滤(例如。, acme.com) |
teams |
string[] | 按团队名称筛选 |
created_after |
string | ISO 8601时间戳 |
created_before |
string | ISO 8601时间戳 |
export_meeting / export_all_meetings
| 参数 | 类型 | 说明 |
|---|---|---|
recording_id |
number | 要导出的会议(仅限导出会议) |
created_after |
string | 仅在此日期之后导出 |
created_before |
string | 仅在此日期之前导出 |
output_dir |
string | 自定义输出目录 |
create_webhook
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
destination_url |
string | 是 | Webhook端点URL |
include_transcript |
boolean | 否 | 在有效载荷中包含转录 |
include_summary |
boolean | 否 | 在有效载荷中包含摘要 |
include_action_items |
boolean | 否 | 包括操作项 |
include_crm_matches |
boolean | 否 | 包括CRM数据 |
triggered_for |
string[] | 否 | 触发webhook的录制类型 |
导出成绩单格式
导出的会议将另存为markdown,其中包含:
- 元数据表 --日期、持续时间、参与者、Fathom链接
- AI摘要 --Fathom生成的摘要
- 行动项 --有指定人员和完成状态
- 完整成绩单 --标有时间戳的演讲者
文件名示例: Quarterly_Business_Review_2024-12-01.md
# Quarterly Business Review
## Meeting Details
| Field | Value |
|-------|-------|
| **Date** | Sunday, December 1, 2024 at 10:00 AM |
| **Duration** | 45m 32s |
| **Recorded by** | Jane Smith <jane@company.com> |
## Participants
- **John Doe** <john@client.com> _(external)_
- **Jane Smith** <jane@company.com>
## Summary
> Key discussion points and outcomes...
## Action Items
- [ ] Follow up on proposal _(assigned to Jane)_
- [x] Send meeting notes
## Transcript
**John Doe** _[00:00:15]_
> Thanks for joining today...
速率限制
Fathom API允许 每分钟60个请求MCP服务器优雅地处理了这一点。
安全
- API密钥存储在Cursor的MCP配置中(不在代码中)
- 永远不要承诺你的
mcp.json或版本控制的API密钥 - Webhook机密应安全存储
故障排除
MCP未加载?
- 确保编辑后重新启动了Cursor
mcp.json - 检查路径
dist/index.js是正确的 - 验证您的API密钥是否有效
“获取失败”错误?
- 确保你使用的是Node.js 18或更高版本
- 检查您的网络连接
- 验证Fathom设置中的API密钥权限
发展
# Install dependencies
npm install
# Build TypeScript
npm run build
# Watch mode for development
npm run dev
许可证
MIT许可证——见 许可证 了解详情。
作者
马修·伯格文森
警惕咨询
需要快速构建自定义AI工具?
我们为企业构建生产就绪的MCP服务器、人工智能集成和自动化工具。
📧 operations@vigilanteconsulting.com
此MCP服务器未正式隶属于Fathom Video,股份有限公司。