非公式 Fellow MCP サーバー

免責事項: これは Fellow.ai API 用のコミュニティによって管理されている非公式の MCP サーバーです。Fellow, Inc. とは提携、推奨、または関連していません。「Fellow」は Fellow, Inc. の登録商標です。

Fellow.ai API をラップするローカル MCP (Model Context Protocol) サーバーであり、会議データ、トランスクリプト、要約、アクションアイテム、参加者にアクセスするためのツールを提供します。

機能:

• 会議データをキャッシュするためのローカル SQLite データベース

• アクションアイテムを最新の状態に保つための自動増分同期

• キャッシュされたノートの全文検索

• 参加者による会議の検索

インストール

npm install -g unofficial-fellow-mcp

セットアップ

1. Fellow API クレデンシャルの取得

1. Fellow アカウントにログインします

2. ユーザー設定内の Developer API 設定に移動します

3. 新しい API キーを生成します

4. ワークスペースのサブドメイン（URL の .fellow.app より前の部分）を控えておきます

2. MCP クライアントの設定

MCP クライアントの設定（例: ~/.config/opencode/opencode.json）に以下を追加します：

{
  "mcp": {
    "fellow": {
      "type": "local",
      "command": ["npx", "-y", "unofficial-fellow-mcp"],
      "environment": {
        "FELLOW_API_KEY": "YOUR_FELLOW_API_KEY_HERE",
        "FELLOW_SUBDOMAIN": "YOUR_SUBDOMAIN"
      },
      "enabled": true
    }
  }
}

利用可能なツール

API ツール (直接 Fellow API を呼び出す)

search_meetings

Fellow 内の会議や録画を検索します。

パラメータ:

• title (任意): 会議タイトルでフィルタリング（大文字小文字を区別しない部分一致）

• created_at_start (任意): この日付以降に作成された会議でフィルタリング（ISO 形式）

• created_at_end (任意): この日付以前に作成された会議でフィルタリング（ISO 形式）

• limit (任意): 結果の最大数（1〜50、デフォルトは 20）

get_meeting_transcript

話者ラベルとタイムスタンプ付きの会議録画の完全なトランスクリプトを取得します。

パラメータ:

• recording_id (任意): 録画 ID

• meeting_title (任意): 会議タイトルで検索

get_meeting_summary

アジェンダ項目、議論トピック、決定事項を含む会議の要約やノートの内容を取得します。

パラメータ:

• note_id (任意): ノート ID

• recording_id (任意): 録画に関連付けられたノートの要約を取得

• meeting_title (任意): 会議タイトルで検索

get_action_items

単一の会議ノートからアクションアイテムを抽出します。

パラメータ:

• note_id (任意): ノート ID

• meeting_title (任意): 会議タイトルで検索

get_meeting_participants

会議の参加者リストを取得します。

パラメータ:

• note_id (任意): ノート ID

• meeting_title (任意): 会議タイトルで検索

データベースツール (ローカル SQLite キャッシュ)

sync_meetings

Fellow API からローカルデータベースへ会議を同期します。

パラメータ:

• force (任意、デフォルト: false): true の場合、完全な再同期を実行します。それ以外の場合は増分同期（前回の同期以降の新規/更新分のみ）を行います

• include_transcripts (任意、デフォルト: false): true の場合、トランスクリプトも取得して保存します（低速）

get_all_action_items

ローカルデータベースからすべてのアクションアイテムを取得します。データが最新であることを保証するため、最初に自動的に増分同期を実行します。

パラメータ:

• assignee (任意): 担当者名でフィルタリング（部分一致）

• show_completed (任意、デフォルト: false): true の場合、完了したアクションアイテムを含めます

• since (任意): この日付以降の会議のアクションアイテムのみを返します（ISO 形式: YYYY-MM-DD）

get_meetings_by_participants

特定の参加者が含まれる会議を検索します。

パラメータ:

• emails (必須): 検索するメールアドレスのリスト

• require_all (任意、デフォルト: false): true の場合、指定されたすべての参加者が出席した会議のみを返します

search_cached_notes

キャッシュされたすべての会議ノート（タイトルと内容）を対象に全文検索を行います。

パラメータ:

• query (必須): 検索クエリ

get_sync_status

現在の同期ステータスとデータベースの統計情報を取得します。

ローカルデータベース

会議データは ~/.unofficial-fellow-mcp/fellow.db にあるローカルの SQLite データベースにキャッシュされます。これにより以下が可能になります：

• 高速なローカル検索

• すべてのアクションアイテムに対するクエリ

• 参加者による会議の検索

• キャッシュされたデータへのオフラインアクセス

データベースには以下が保存されます：

• ノート（会議の要約、アジェンダ、内容）

• 録画（オプションでトランスクリプトを含む）

• アクションアイテム（ノートから解析され、担当者や期限が抽出されたもの）

• 参加者（メールアドレス）

環境変数

開発

# Clone the repository
git clone <repo-url>
cd unofficial-fellow-mcp

# Install dependencies
npm install

# Create .env file with your credentials
echo "FELLOW_API_KEY=your_api_key_here" > .env
echo "FELLOW_SUBDOMAIN=your_subdomain" >> .env

# Watch mode for development
npm run dev

# Build
npm run build

# Test API connection
node --env-file=.env test-api.js

# Test MCP server
FELLOW_API_KEY=your_key FELLOW_SUBDOMAIN=your_subdomain node test-mcp.js

要件

• Node.js >= 18.0.0

• API アクセス権を持つ Fellow.ai アカウント

ライセンス

MIT

API リファレンス

この MCP サーバーは Fellow Developer API をラップしています。API は以下を使用します：

• 認証用の X-API-KEY ヘッダー

• リスト操作用の POST リクエスト（フィルタ/ページネーション用の JSON ボディを含む）

• 個別のリソースを取得するための GET リクエスト