Brest MCP Server

Brest MCP Server

Brest 地域向けの堅牢な Model Context Protocol（MCP）サーバー実装です。組み込みのデバッグ機能と監視機能を備え、MCP ベースのやり取りを支えるインフラストラクチャを提供します。

目次

• 概要
• 機能
• 前提条件
• 使用技術
• インストール
• 使い方
  • サーバーの起動
  • クライアントの使用
  • AI エージェントとの統合
• 開発
• トラブルシューティング
• コントリビューション
• ライセンス

概要

Brest MCP Server は、Brest 地域向けの Model Context Protocol（MCP）サーバー実装です。MCP ベースのやり取りを管理するための堅牢なインフラストラクチャを提供し、デバッグと監視のための MCP インスペクターも備えています。

このプロジェクトの目標は、シンプルさと信頼性を重視しながら、MCP サービスのデプロイと管理を容易にすることです。

機能

• 🚀 MCP プロトコルの実装：Model Context Protocol の標準に完全準拠
• 🔍 組み込みインスペクター：統合されたウェブインターフェースで MCP サーバーをデバッグおよび監視
• 🤖 AI エージェントとの統合：A2A プロトコルとエージェント間通信をサポート
• 🐍 Python ベース：最新の開発手法を取り入れ、Python 3.12 以降で構築
• 📦 UV によるパッケージ管理：高速で信頼性の高い依存関係管理
• 🔧 開発ツール：クライアントツールとデバッグユーティリティを同梱

前提条件

Brest MCP Server をインストールする前に、以下を用意してください。

• Python 3.12.3 以降
• Node.js（MCP Inspector 用）
• Git（リポジトリのクローン用）
• uv パッケージマネージャー（インストール手順は以下を参照）

使用技術

• 言語：Python 3.12.3 以降の互換バージョン
• 依存関係管理：uv
• インスペクター：Node.js（npx）経由の MCP Inspector
• 環境：uv で管理する仮想環境
• プロトコル：Model Context Protocol（MCP）および A2A（エージェント間通信）

インストール

Brest MCP Server をローカルにインストールして設定するには、次の手順に従ってください。

1. uv をインストール（まだインストールしていない場合）：

   • Linux/macOS の場合：

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

   • Windows の場合：

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     

2. リポジトリをクローン：

   git clone https://github.com/Nijal-AI/Brest-mcp-server.git
   cd Brest-mcp-server
   

3. 仮想環境を作成して有効化：

   uv venv
   source .venv/bin/activate  # Windows の場合: .venv\Scripts\activate
   

4. 依存関係をインストール：

   uv sync
   

使い方

サーバーの起動

サーバーをローカルで実行するには、次の手順に従ってください。

1. 仮想環境が有効になっていることを確認：

   source .venv/bin/activate  # Windows の場合: .venv\Scripts\activate
   

2. MCP Inspector とともにサーバーを起動：

   npx @modelcontextprotocol/inspector uv run brest-mcp
   

3. ブラウザーで MCP Inspector にアクセス：

   • プロキシ：http://localhost:3000
   • ウェブインターフェース：http://localhost:5173

出力例：

Starting MCP inspector...
Proxy server listening on port 3000
🔍 MCP Inspector is up and running at http://localhost:5173 🚀

クライアントの使用

Brest MCP Server を使用して AI エージェントと通信する場合は、tools ディレクトリにあるクライアントを使用できます。

uv run python tools/client.py src/server.py

AI エージェントとの統合

A2A プロトコルを使用して、Brest MCP Server の AI エージェントとチャットすることもできます。

1. エージェントをセットアップします：

   echo "MCP_TRANSPORT=stdio" > src/.env
   

2. エージェントを実行します：

   uv run agent
   

3. A2A samples デモで使用します（任意）：

   # セットアップ
   git clone https://github.com/google-a2a/a2a-samples.git
   echo "GOOGLE_API_KEY=your_api_key_here" > a2a-samples/demo/ui/.env
   
   # 実行
   cd a2a-samples/demo/ui
   uv run main.py
   

   次に、http://localhost:12000 にアクセスして「Agents」に移動し、localhost:10030 にある Brest Expert Agent に接続します。必要に応じて他のエージェントを追加し、「Home」に移動して新しい会話を作成し、エージェントと話し合うことができます。

開発

コントリビューションや高度な機能の開発を希望する開発者は、以下の手順も実行してください。

1. 仮想環境がセットアップされ、依存関係がインストールされていることを確認します：

   uv venv
   uv sync
   

2. MCP Inspector を使用してサーバーのデバッグと監視を行います：

   npx @modelcontextprotocol/inspector uv run brest-mcp
   

3. 依存関係と構成の詳細については、pyproject.toml ファイルを参照してください。

トラブルシューティング

よくある問題

仮想環境を有効化できない

• uv が正しくインストールされ、PATH に含まれていることを確認してください
• 仮想環境を再作成してみてください：uv venv --force

MCP Inspector が起動しない

• Node.js がインストールされていることを確認してください：node --version
• npm キャッシュをクリアしてください：npm cache clean --force
• Inspector をグローバルにインストールしてみてください：npm install -g @modelcontextprotocol/inspector

A2A samples への接続エラー

• Google API キーが .env ファイルに正しく設定されていることを確認してください
• Brest Expert Agent が localhost:10030 で実行されていることを確認してください
• 必要なすべてのポートが使用可能で、ファイアウォールによってブロックされていないことを確認してください

依存関係のインストールに失敗する

• uv を最新バージョンに更新してください：uv self update
• キャッシュをクリアしてください：uv cache clean
• 詳細な出力を有効にしてインストールを試してください：uv sync -v

ヘルプの利用

ここに記載されていない問題が発生した場合：

1. GitHub の Issues セクションを確認してください
2. MCP プロトコルのドキュメントを確認してください
3. 詳細なエラーメッセージと環境情報を添えて、新しい issue を作成してください

コントリビューション

コントリビューションを歓迎します！変更を提案するには：

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feature/your-feature-name
3. 変更を加え、テストが通ることを確認します
4. プロジェクトで定められたコーディング規約に従います
5. 変更内容を明確に説明してプルリクエストを送信します

詳しいガイドラインについては、CONTRIBUTING.md ファイルを参照してください。

ライセンス

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