Fathom MCP

🚀 fathom - mcp

Fathom.video用のMCPサーバー — Cursor IDEから直接、AIによる会議の文字起こし、要約、アクションアイテムにアクセスできます。

Model Context Protocol (MCP)サーバーで、Fathom.videoをCursorのようなAIコーディングアシスタントと統合します。自然言語を使って、会議の文字起こしを照会し、録画をMarkdownにエクスポートし、参加者で検索し、Webhookを管理できます。

✨ 主な機能

• 📋 会議の一覧表示と検索 — 日付、チーム、参加者、または外部ドメインでフィルタリングして録画を閲覧します。
• 📝 完全な文字起こし — 話者ラベル付き、タイムスタンプ付きの文字起こしをMarkdown形式で取得します。
• 📊 AIによる要約 — FathomのAIによって生成された会議の要約にアクセスします。
• ✅ アクションアイテム — 特定の会議または最近の通話全体からアクションアイテムを取得します。
• 📁 Markdownへのエクスポート — 会議をMeetingTitle_YYYY - MM - DD.mdファイルとして保存します。
• 👥 チーム管理 — チームとチームメンバーを一覧表示します。
• 🔔 Webhook — リアルタイム通知用のWebhookを作成および管理します。

🚀 クイックスタート

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にエクスポート"
• "今週のアクションアイテムを表示"

📚 ドキュメント

会議操作

エクスポート操作

アクションアイテム

チーム管理

Webhook

ツールのパラメーター

エクスポートされた文字起こしの形式

エクスポートされた会議は、以下の内容を含むMarkdownとして保存されます。

• メタデータテーブル — 日付、時間、参加者、Fathomのリンク
• AI要約 — Fathomによって生成された要約
• アクションアイテム — 担当者と完了ステータス付き
• 完全な文字起こし — 話者ラベル付きでタイムスタンプ付き

例のファイル名: Quarterly_Business_Review_2024 - 12 - 01.md

# Quarterly Business Review

## Meeting Details
| 項目 | 値 |
|-------|-------|
| **日付** | 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は1分間に60回のリクエストを許可しています。MCPサーバーはこれを適切に処理します。

セキュリティ

• APIキーはCursorのMCP設定に保存されます（コード内には保存されません）。
• mcp.jsonやAPIキーをバージョン管理にコミットしないでください。
• Webhookシークレットは安全に保存する必要があります。

トラブルシューティング

MCPが読み込まれない場合

• mcp.jsonを編集した後にCursorを再起動したことを確認してください。
• dist/index.jsのパスが正しいことを確認してください。
• APIキーが有効であることを確認してください。

"fetch failed"エラーが発生する場合

• Node.js 18以上を使用していることを確認してください。
• ネットワーク接続を確認してください。
• Fathom設定でAPIキーの権限を確認してください。

開発

# 依存関係をインストールする
npm install

# TypeScriptをビルドする
npm run build

# 開発用のウォッチモード
npm run dev

📄 ライセンス

MITライセンス — 詳細はLICENSEを参照してください。

作者

Matthew Bergvinson
Vigilante Consulting

カスタムAIツールをすばやく構築する必要がありますか？

私たちは、企業向けの本番環境対応のMCPサーバー、AI統合、および自動化ツールを構築しています。

📧 operations@vigilanteconsulting.com

このMCPサーバーは、Fathom Video, Inc.と公式に関連付けられていません。