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. 無官方關聯。