Fireflies MCP

🚀 Fireflies MCP サーバー

Fireflies.ai API 用の MCP サーバーで、会議の録音文字起こしの検索、特定の録音文字起こしの詳細情報の取得、キーワード検索、録音文字起こしの要約生成などの機能を提供します。

🚀 クイックスタート

この MCP サーバーを使用することで、Fireflies.ai API を通じて会議の録音文字起こしの管理や要約生成を行うことができます。以下に、基本的な使い方を説明します。

✨ 主な機能

• 文字起こし管理：会議の文字起こしを検索し、フィルタリングオプションを使用して特定の条件に合致する文字起こしを探すことができます。
• 詳細情報取得：特定の文字起こしの詳細情報を取得できます。
• 高度な検索：特定のキーワードやフレーズを含む文字起こしを検索できます。
• 要約生成：会議の文字起こしの要約を生成し、複数の形式で出力することができます。

📦 インストール

リポジトリのクローン

git clone <repository_url>

依存関係のインストール

npm install
# または
pnpm install

プロジェクトのビルド

npm run build
# または
pnpm build

💻 使用例

基本的な使用法

fireflies_get_transcripts の使用例

# 2024年1月1日から2024年1月31日までの最大10件の文字起こしを取得
from fireflies_api import fireflies_get_transcripts
transcripts = fireflies_get_transcripts(limit=10, from_date='2024-01-01', to_date='2024-01-31')
print(transcripts)

高度な使用法

fireflies_generate_summary の使用例

# 特定の文字起こしの要約を段落形式で生成
from fireflies_api import fireflies_generate_summary
summary = fireflies_generate_summary(transcript_id='your_transcript_id', format='paragraph')
print(summary)

📚 ドキュメント

ツールの詳細

1. fireflies_get_transcripts

   • オプション付きのフィルターで会議の文字起こしのリストを取得します。
   • 入力パラメータ：
     • limit（オプションの数値）：返される最大文字起こし数
     • from_date（オプションの文字列）：開始日（ISO 形式：YYYY-MM-DD）
     • to_date（オプションの文字列）：終了日（ISO 形式：YYYY-MM-DD）
   • 返却結果：基本情報を含む文字起こしオブジェクトの配列

2. fireflies_get_transcript_details

   • 特定の文字起こしの詳細情報を取得します。
   • 入力パラメータ：
     • transcript_id（文字列）：取得する文字起こしの ID
   • 返却結果：話者、内容、メタデータを含む詳細な文字起こし情報

3. fireflies_search_transcripts

   • 特定のキーワードを含む文字起こしを検索します。
   • 入力パラメータ：
     • query（文字列）：検索に使用するキーワード
     • limit（オプションの数値）：返される最大文字起こし数
   • 返却結果：一致する文字起こしオブジェクトの配列

4. fireflies_generate_summary

   • 会議の文字起こしの要約を生成します。
   • 入力パラメータ：
     • transcript_id（文字列）：要約する文字起こしの ID
     • format（オプションの文字列）：要約の形式（'bullet_points' または 'paragraph'）
   • 返却結果：生成された要約テキスト

設定ガイド

Fireflies API Key の設定

Fireflies API Key を作成 し、適切な権限を設定します。

1. Fireflies.ai 管理画面にログインします。
2. 設定 > API ページに移動します。
3. 新しい API Key を生成します。
4. 生成された API Key をコピーします。

Claude Desktop での使用方法

Claude Desktop でこの MCP サーバーを使用するには、claude_desktop_config.json ファイルに以下の内容を追加します。

{
  "mcpServers": {
    "fireflies": {
      "command": "npx",
      "args": [
        "-y",
        "@props-labs/mcp/fireflies"
      ],
      "env": {
        "FIREFLIES_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

サーバーの起動

FIREFLIES_API_KEY=your_api_key npm start
# または
FIREFLIES_API_KEY=your_api_key pnpm start

または、インストールスクリプトを使用することもできます。

./setup.sh
FIREFLIES_API_KEY=your_api_key npm start

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で公開されています。これは、MIT ライセンスの条項と条件に従って、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。