MCP Agent 2p6

🚀 MCP 代理項目ドキュメント

MCP Agent は、複数のサービスを統合することで強力な機能を提供する多目的コントロールプラットフォームです。このドキュメントでは、プロジェクトの構造、設定、および使用方法について詳しく説明します。

🚀 クイックスタート

1. プロジェクトリポジトリをクローンします。

   git clone https://github.com/yourusername/mcp-agent.git
   

2. 依存関係をインストールします。

   cd mcp-agent/mcp-agent-app && npm install
   

3. 環境変数を設定し、.env.local ファイルに必要な情報を記入します。

4. アプリケーションを起動します。

   npm run dev
   

✨ 主な機能

MCP Agent は、Next.js ベースのフロントエンドアプリと複数のサーバーコンポーネントを統合し、多様なサービスを管理できる機能を提供します。具体的には、WhatsApp メッセージの処理、GitHub API の統合、Google Workspace サービスの管理、および Web 検索結果の提供などが可能です。

📦 インストール

1. プロジェクトリポジトリをクローンします。

   git clone https://github.com/yourusername/mcp-agent.git
   

2. 依存関係をインストールします。

   cd mcp-agent/mcp-agent-app && npm install
   

📚 ドキュメント

プロジェクトコンポーネント

コアコンポーネント

• mcp-agent-app：Next.js ベースのフロントエンドアプリで、ユーザーインタラクションと API リクエストを処理します。
• MCP 設定ファイル：MCP サーバーの接続パラメータとツールのスキーマを定義します。
• LLM 設定ファイル：ユーザーインターフェイスに LLM プロバイダーとモデルの定義を提供します。

プロジェクト構造

mcp-agent/ (プロジェクトのルートディレクトリ)
├── .gitignore
├── LICENSE
├── README.md (このファイル)
├── docs/ (追加ドキュメント)
├── mcp-agent-app/ (Next.js アプリケーション)
│   ├── .env.local (API Key、パス、データベース URL)
│   ├── llm-config.json (UI 用の LLM プロバイダー/モデル定義)
│   ├── mcp-config.json (MCP サーバーコマンド設定)
│   ├── next.config.ts
│   ├── package.json
│   ├── prisma/
│   │   └── schema.prisma (データベーススキーマ)
│   │   └── migrations/ (マイグレーションファイル)
│   ├── src/
│   │   ├── app/
│   │   │   ├── api/
│   │   │   │   ├── chat/route.ts (Vercel AI SDK を使用するメインチャット API)
│   │   │   │   └── chats/ (チャット履歴の保存/読み込み用 API ルート)
│   │   │   └── page.tsx (ホームページコンポーネント)
│   │   ├── components/ (React コンポーネント：ChatInterface、Sidebar など)
│   │   ├── context/
│   │   │   └── ChatContext.tsx (アプリケーションの状態を管理し、useChat フックを統合)
│   │   └── lib/
│   │       └── prisma.ts (Prisma クライアントインスタンス)
│   └── ... (その他の Next.js ファイル)
├── duckduckgo-mcp-server/ (DuckDuckGo 検索 MCP サーバーのソースコード)
├── github-mcp-server/ (GitHub MCP サーバーのソースコード、Docker イメージを使用する場合は直接実行する必要はありません)
├── mcp-gsuite/ (GSuite MCP サーバーのソースコード)
└── whatsapp-mcp/
    ├── whatsapp-bridge/ (Go コンポーネント - 個別に実行する必要があります)
    └── whatsapp-mcp-server/ (Python コンポーネント)

設定ファイルの説明

.env.local ファイル

このファイルは、プロジェクトの実行に必要な環境変数を格納します。具体的には以下のものが含まれます。

• API Key：GitHub、GSuite などの各種サービスにアクセスするためのキー。
• パス設定：各 MCP サーバーコンポーネントの位置を指定します。
• データベース URL：アプリケーションが接続するデータベースのアドレスを定義します。

llm-config.json ファイル

このファイルは、ユーザーインターフェイスに LLM プロバイダーとモデルの詳細情報を提供し、選択と設定を容易にします。

mcp-config.json ファイル

このファイルは、各 MCP サーバーの接続パラメータを定義します。具体的には以下のものが含まれます。

• id：一意の識別子。
• description：簡単な説明。
• command：実行コマンドで、オプションパラメータと環境変数の設定を含みます。

現在の MCP サーバー実装

WhatsApp MCP サーバー

• ソースコードの位置：whatsapp-mcp/
• 実行方法：Go コンポーネントと Python スクリプトを介して実行します。
• 機能：WhatsApp メッセージとインタラクションを処理します。

GitHub MCP サーバー

• ソースコードの位置：github-mcp-server/
• 実行方法：Docker イメージをベースに実行します。
• 機能：GitHub API を統合し、自動化操作を実現します。

GSuite MCP サーバー

• ソースコードの位置：mcp-gsuite/
• 実行方法：Python スクリプトを直接実行します。
• 機能：Google Workspace サービスを管理します。

DuckDuckGo 検索 MCP サーバー

• ソースコードの位置：duckduckgo-mcp-server/
• 実行方法：HTTP リクエストを介して呼び出します。
• 機能：Web 検索結果を提供します。

新しい MCP サーバーの追加

新しい MCP サーバーを追加するには、以下の手順に従ってください。

1. mcp-config.json ファイルを更新する：

   • 新しいサーバーエントリを追加し、一意の識別子と説明を含めます。
   • 実行コマンドを設定し、オプションパラメータと環境変数を含めます。

2. サーバーコンポーネントを実装する：

   • 必要に応じてコードを記述し、既存のアーキテクチャと互換性を確保します。
   • 機能と設定方法に関する詳細なドキュメントを提供します。

3. テストと統合：

   • 新しいサーバーがメインアプリケーションと正常に通信することを確認します。
   • すべての潜在的な依存関係とエラー状況を処理します。

🔧 技術詳細

MCP 代理プロトコル（JSON - RPC）

MCP は JSON - RPC プロトコルを使用して通信します。具体的なインターフェース定義は以下の通りです。

リクエスト形式

{
    "jsonrpc": "2.0",
    "method": "string",
    "params": "array",
    "id": "integer"
}

レスポンス形式

{
    "jsonrpc": "2.0",
    "result": "object",
    "id": "integer"
}

データベース構造

• チャット記録テーブル：chat_records
  • id：整数型、主キー。
  • content：テキスト型、チャット内容を格納します。
  • timestamp：タイムスタンプ型、作成時間を記録します。

🤝 貢献ガイド

コミュニティからの貢献を歓迎します！PR を提出する前に、CONTRIBUTING.md ファイルを読んで、コード規約と提出手順を確認してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細は LICENSE ファイルを参照してください。

⚠️ 重要な注意事項

このドキュメントは継続的に更新されています。詳細な情報は、後続のバージョンのリリースを確認してください。