MCP Server 5s8

🚀 MCP サーバー

MCP サーバーは、AI 駆動のコマンド実行とツール管理のための柔軟なフレームワークを提供します。

🚀 クイックスタート

MCP サーバーは、AI 駆動のコマンド実行とツール管理を行うためのフレームワークです。以下に、MCP サーバーの基本的な使い方を説明します。

✨ 主な機能

• コマンド実行ツール：シェルコマンドの実行と管理に使用します。
• 非同期コマンド実行：ロングポーリング (Long Polling)、サーバー送信イベント (SSE)、および WebSocket 通信をサポートします。
• ファイル処理ツール：ファイルのアップロード、ダウンロード、および変換機能を備えています。

📦 インストール

手動インストール

# uv を使用する場合（推奨）：
uv pip install -e ./mcp_core
uv pip install -e ./mcp_tools
uv pip install -e .

# または pip を使用する場合：
pip install -e ./mcp_core
pip install -e ./mcp_tools
pip install -e .

これにより、すべてのローカルパッケージが開発モードでインストールされ、コードを変更した際にそれらのパッケージを使用できるようになります。

📚 ドキュメント

プロジェクト構造

MCP プロジェクトは以下の部分で構成されています。

• mcp_core/：コアタイプとアダプター
  • mcp_core/tests/：コアタイプと機能のテスト
• mcp_tools/：ユーティリティツールと実装
  • mcp_tools/command_executor/：コマンド実行ツール
  • mcp_tools/tests/：ユーティリティツールのテスト
• server/：MCP サーバーの主要な実装
  • server/tests/：サーバー固有の機能テスト
  • server/.private/：プライベートな設定ディレクトリ（git で無視されます）
• scripts/：プロジェクト管理のためのユーティリティスクリプト
• assets/：プロジェクトのアセットとドキュメント内の画像
• config/：集中型の設定モジュール
  • config/templates/：設定テンプレート

環境設定

MCP プロジェクトは .env ファイルに基づく集中型の環境設定システムを使用しています。これにより、異なるコンポーネントが一貫した設定を維持できます。

環境の設定

1. テンプレートファイルをコピーして .env ファイルを作成します。

cp config/templates/env.template .env

2. .env ファイルを編集して環境設定を構成します。

# リポジトリ情報
GIT_ROOT=/path/to/git/repo
WORKSPACE_FOLDER=/path/to/workspace
PROJECT_NAME=mcp_project

# Azure リポジトリ設定
AZREPO_ORG=your_organization_name
AZREPO_PROJECT=your_project_name

3. 環境変数をターミナルまたは IDE に追加します。

export $(cat .env | grep -vE "^\s*#" | cut -d= -f1)

VSCode/Cursor での MCP サーバーの設定

.env ファイルを通じて MCP サーバーを設定することを推奨しますが、エディタの設定で上書きすることもできます。

{
    "mcpServers": {
      "mymcp": {
        "command": "python",
        "args": ["server/main.py"],
        "env": {
          "GIT_ROOT": "${workspaceFolder}"
        }
      },
      "mymcp-sse" : {
        "url": "http://0.0.0.0:8000/sse"
      }
    }
}

テストの実行

pytest を手動で使用してテストを実行できます。

# すべてのテストを実行
python -m pytest

# 特定のコンポーネントのテストを実行
python -m pytest mcp_core/tests
python -m pytest mcp_tools/tests
python -m pytest server/tests

サンプルスクリーンショット