MCP

🚀 BolideAI MCP

BolideAI MCPは、マーケティング自動化、コンテンツ生成、調査、およびプロジェクト管理のためのツールを提供する包括的なModelContextProtocol (MCP)サーバーです。様々なAIサービスと統合し、開発者やマーケターのワークフローを合理化します。

✨ 主な機能

• 🚀 プロジェクトのスキャフォールディング - マーケティングプロジェクトのディレクトリと構造を作成します。
• 📱 マーケティング自動化 - コンパニオンアプリを使用してスクリーンショットやビデオをキャプチャします。
• 🤖 AIによるコンテンツ生成 - Gemini AIを使用してソーシャルメディアの投稿を生成します。
• 🔍 調査ツール - Perplexity AIとOpenAIを使用した包括的な調査を行います。
• 🛠️ 診断ツール - システムの検証とトラブルシューティングを行います。

🚀 クイックスタート

クイックテスト（NPMパッケージ）

ローカルビルドを行わずにすぐにテストするには、以下の手順を実行します。

インストール

npm install -g @bolide-ai/mcp

または、npxを使用することをおすすめします。

npx --package=@bolide-ai/mcp bolide-ai-mcp

設定

MCPクライアントを以下のように設定します。

{
  "mcpServers": {
    "BolideAI": {
      "command": "npx --package=@bolide-ai/mcp bolide-ai-mcp",
      "env": {
        "BOLIDEAI_API_KEY": "your-api-key",
      }
    }
  }
}

開発環境のセットアップ（ローカルビルド）

開発またはローカルビルドの場合は、以下の詳細な手順に従ってください。

1. 前提条件のインストール

Node.js 22+をインストールする

# https://nodejs.org/en/download からダウンロードしてインストールします。

リポジトリをクローンする

git clone https://github.com/Bolide-AI/mcp

2. MCPサーバーのビルド

# クローンしたリポジトリのディレクトリで
npm install && npm run build

4. CursorでMCPを設定する

1. Cursorメニューで Cursor → Settings → Cursor Settings を選択します。
2. 開いたウィンドウで Tools & Integrations を選択します。
3. New MCP Server をクリックします。
4. MCPサーバーの設定を挿入し、以下を置き換えます。
   • <PATH TO MCP DIRECTORY> をMCPディレクトリのパスに置き換えます。
   • <BOLIDEAI_API_TOKEN> をあなたのBolideAIキーに置き換えます（ここで生成できます）。

{
  "mcpServers": {
    "BolideAI-dev": {
      "type": "stdio",
      "command": "node",
      "args": [
        "--inspect=9999",
        "<PATH TO MCP DIRECTORY>/build/index.js"
      ],
      "env": {
        "BOLIDEAI_MCP_DEBUG": "true",
        "BOLIDEAI_API_TOKEN": "<your-api-key-here>"
      }
    }
  }
}

5. ワークスペースがCursorで開かれていることを確認します。
6. シミュレーターでアプリケーションを起動します。

ツールの使用を開始する

// プロジェクトを作成する
scaffold_bolide_ai_project()

// 調査を行う
use_openai_deep_research({ 
  query: "AI trends in marketing automation 2024" 
})

// スクリーンキャストの内容を分析する
analyze_screencasts({ 
  screencastNames: ["demo.mov"],
  force: false
})

💻 使用例

基本的な使用法

// プロジェクトを作成する
scaffold_bolide_ai_project()

// 調査を行う
use_openai_deep_research({ 
  query: "AI trends in marketing automation 2024" 
})

// スクリーンキャストの内容を分析する
analyze_screencasts({ 
  screencastNames: ["demo.mov"],
  force: false
})

高度な使用法

// 高度な調査を行う
use_openai_deep_research({ 
  query: "Economic impact of renewable energy adoption" 
})

環境変数

• BOLIDEAI_API_TOKEN - 調査ツールに必要です。
• BOLIDEAI_API_URL - オプションで、デフォルトは https://bolide.ai/api です。

ツールの設定

• BOLIDEAI_MCP_DEBUG=true - 診断ツールと詳細なログを有効にします。
• ツールグループ - 特定のツールカテゴリを有効にします（ツールオプションを参照）。
• 個別のツール - 特定のツールのみを有効にします（ツールオプションを参照）。

利用可能なツール

BolideAI MCPは、5つのカテゴリにわたる10個のツールを提供します。

🚀 プロジェクトのスキャフォールディング

• scaffold_bolide_ai_project - bolide.aiプロジェクトのディレクトリ構造を作成します。

📱 ユーティリティツール

• check_companion_app_status - コンパニオンアプリの実行状態を確認します。
• launch_companion_app - マーケティングキャプチャ用のコンパニオンアプリを起動します。
• stop_companion_app - 実行中のコンパニオンアプリのインスタンスを停止します。
• install_brew_and_ffmpeg - HomebrewパッケージマネージャーとFFmpegをインストールします。

🤖 コンテンツ生成

• analyze_screencasts - Gemini AIを使用してスクリーンキャストの内容を分析します。
• generate_gif - スクリーンキャストのセグメントをGIFに変換します。
• enhance_audio - ElevenLabsを使用してスクリーンキャストからオーディオを抽出して強化します。

🔍 調査ツール

• use_perplexity - Perplexity AIを使用して調査を行います。
• use_openai_deep_research - OpenAI o4-mini-deep-researchを使用して深い調査を行います。

🛠️ 診断ツール

• diagnostic - システム環境の検証（デバッグモードのみ）

調査ツール

Perplexity AIによる調査

迅速な調査と情報収集を行います。

use_perplexity({ 
  query: "Latest trends in AI marketing automation",
  search_mode: "web" // または "academic"
})

OpenAIによる深い調査

クエリの拡充を伴う包括的な調査を行います。

use_openai_deep_research({ 
  query: "Economic impact of renewable energy adoption" 
})

深い調査ツールは以下のように動作します。

1. 拡充 - GPT-4.1を使用して詳細な調査指示でクエリを拡充します。
2. 調査 - o4-mini-deep-researchを使用してウェブ検索とコードインタープリターで調査を行います。
3. 返却 - 拡充された指示と包括的な調査結果の両方を返します。

一般的なワークフロー

完全なマーケティングコンテンツ作成

1. プロジェクト構造を設定する

   scaffold_bolide_ai_project()
   

2. アプリの状態を確認し、コンテンツをキャプチャする

   check_companion_app_status()
   launch_companion_app()
   

3. オーディオ品質を向上させる

   enhance_audio({ 
     screencastNames: ["demo.mov"]
   })
   

調査ワークフロー

1. 迅速な調査

   use_perplexity({ 
     query: "Your research question",
     search_mode: "web"
   })
   

2. 深い調査

   use_openai_deep_research({ 
     query: "Complex research topic requiring comprehensive analysis"
   })
   

設定オプション

選択的なツール登録

必要なツールのみを有効にしてパフォーマンスを最適化します。

{
  "env": {
    "BOLIDEAI_MCP_GROUP_RESEARCH": "true",
    "BOLIDEAI_MCP_GROUP_CONTENT_GENERATORS": "true",
    "BOLIDEAI_API_TOKEN": "your-api-key"
  }
}

利用可能なツールグループ

• BOLIDEAI_MCP_GROUP_LAUNCH - 起動とユーティリティツール
• BOLIDEAI_MCP_GROUP_SCAFFOLDING - プロジェクトのスキャフォールディングツール
• BOLIDEAI_MCP_GROUP_CONTENT_GENERATORS - コンテンツ生成ツール
• BOLIDEAI_MCP_GROUP_RESEARCH - 調査と情報収集ツール
• BOLIDEAI_MCP_GROUP_DIAGNOSTICS - 診断ツール

📚 ドキュメント

• - 包括的なツールドキュメント
• - 設定と選択的なツール登録
• - 開発と貢献のガイドライン

システム要件

依存関係

• Node.js 22+
• ffmpeg（GIF生成ツールに必要）
• コンパニオンアプリ

トラブルシューティング

デバッグモードを有効にする

{
  "env": {
    "BOLIDEAI_MCP_DEBUG": "true"
  }
}

診断を実行する

diagnostic() // デバッグモードでのみ利用可能

一般的な問題

1. APIキーが不足している - すべての必要な環境変数が設定されていることを確認してください。
2. ffmpegが見つからない - brew install ffmpeg を使用してffmpegをインストールしてください。
3. パーミッションの問題 - プロジェクトディレクトリのファイルシステムパーミッションを確認してください。

コントリビュート

私たちはコントリビューションを歓迎します！詳細については、コントリビュートガイドを参照してください。

📄 ライセンス

MIT © Data Route LLC

サポート

• 🐛 問題を報告する
• 💬 サポート

BolideAI MCP - AIベースのツールを使用して、マーケティング自動化と調査ワークフローを合理化します。