Fathom MCP

🚀 Fathom MCP

Fathom MCP 是一个专为 Fathom.video 打造的 MCP 服务器，可让你直接在 Cursor IDE 中访问 AI 会议记录、摘要和待办事项。它通过自然语言处理技术，提供了便捷的会议管理和查询功能，极大地提升了工作效率。

🚀 快速开始

1. 获取 Fathom API 密钥

1. 访问 Fathom 设置。
2. 导航至 API 访问 选项。
3. 点击 生成 API 密钥。

2. 安装 MCP 服务器

git clone https://github.com/matthewbergvinson/fathom-mcp.git
cd fathom-mcp
npm install
npm run build

3. 配置 Cursor

在 ~/.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 替换为你克隆仓库的实际路径，并添加你的 Fathom API 密钥。

4. 重启 Cursor

重启 Cursor 以加载 MCP 服务器。之后，你就可以使用自然语言与 Fathom 数据进行交互，例如：

• "列出我最近的 5 次 Fathom 会议"
• "获取我与 John 的通话记录"
• "将昨天的会议导出为 Markdown 文件"
• "显示本周的待办事项"

✨ 主要特性

• 📋 会议列表与搜索：可按日期、团队、参会人员或外部域名等条件筛选浏览会议记录。
• 📝 完整会议记录：获取带有发言人标签和时间戳的会议记录，并以 Markdown 格式呈现。
• 📊 AI 会议摘要：访问 Fathom 自动生成的会议摘要。
• ✅ 待办事项管理：提取特定会议或近期通话中的待办事项。
• 📁 导出为 Markdown：将会议保存为 会议标题_YYYY-MM-DD.md 格式的文件。
• 👥 团队管理：列出团队和团队成员信息。
• 🔔 网络钩子管理：创建和管理网络钩子，实现实时通知。

💻 使用示例

基础用法

以下是安装和配置 MCP 服务器的基本步骤：

# 克隆仓库
git clone https://github.com/matthewbergvinson/fathom-mcp.git
# 进入项目目录
cd fathom-mcp
# 安装依赖
npm install
# 构建项目
npm run build

高级用法

在开发环境中使用 watch 模式：

# 启动 watch 模式
npm run dev

📚 详细文档

可用工具

会议操作

导出操作

待办事项管理

团队管理

网络钩子管理

工具参数

导出的会议记录格式

导出的会议记录以 Markdown 格式保存，包含以下内容：

• 元数据表格：日期、时长、参会人员、Fathom 链接等信息。
• AI 摘要：Fathom 生成的会议摘要。
• 待办事项：包含负责人和完成状态。
• 完整会议记录：带有发言人标签和时间戳。

示例文件名：季度业务回顾_2024-12-01.md

# 季度业务回顾

## 会议详情
| 字段 | 值 |
|-------|-------|
| **日期** | 2024 年 12 月 1 日，星期日，上午 10:00 |
| **时长** | 45 分 32 秒 |
| **记录人** | Jane Smith <jane@company.com> |

## 参会人员
- **John Doe** <john@client.com> _(外部人员)_
- **Jane Smith** <jane@company.com>

## 摘要
> 关键讨论点和结果...

## 待办事项
- [ ] 跟进提案 _(负责人：Jane)_
- [x] 发送会议记录

## 会议记录
**John Doe** _[00:00:15]_
> 感谢大家今天的参与...

🔧 技术细节

速率限制

Fathom API 每分钟允许 60 次请求，MCP 服务器会妥善处理此限制。

安全性

• API 密钥存储在 Cursor 的 MCP 配置文件中（而非代码中）。
• 切勿将 mcp.json 或 API 密钥提交到版本控制系统。
• 网络钩子密钥应安全存储。

故障排除

⚠️ 重要提示

• MCP 无法加载：请确保在编辑 mcp.json 后重启了 Cursor，检查 dist/index.js 的路径是否正确，并验证 API 密钥的有效性。
• “fetch failed” 错误：请确保使用的是 Node.js 18 或更高版本，检查网络连接，并在 Fathom 设置中验证 API 密钥的权限。

开发

# 安装依赖
npm install

# 构建 TypeScript
npm run build

# 开发环境的 watch 模式
npm run dev

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

作者

Matthew Bergvinson
Vigilante Consulting

需要快速构建自定义 AI 工具？

我们为企业构建可投入生产的 MCP 服务器、AI 集成和自动化工具。

📧 operations@vigilanteconsulting.com

此 MCP 服务器与 Fathom Video, Inc. 无官方关联。