MCP Server Study

🚀 MCP 学習プロジェクト⚡

🌟 プロジェクト概要

このプロジェクトはMCPプロトコルに基づく学習プロジェクトで、主にMCP Serverの実装方法を学ぶために使用されます。 api_serverディレクトリには、FastAPIライブラリを使用して実装された一連のAPIサービスインターフェースがあり、既存システムのJavaバックエンドサービスを模擬しています。このプロジェクトでは、加減乗除の四則演算のみを実装しています。 testsディレクトリには、api_serverに対する単体テストプログラムがあり、pytestの機能を習得するために使用されます。 mcp_serverディレクトリには、MCPのserverの内容が含まれており、MCPの2種類の実装方法があります。

1つ目はstdio方式

主にローカル呼び出し、ローカル実行の方式で、主な実装はserver.pyコードに含まれています。 使用方法はclineプラグインを使用して呼び出すことができ、以下にcline呼び出しのcfg設定を示します。

{
  "mcpServers": {
    "math": {
      "timeout": 60,
      "command": "mcp",
      "args": [
        "run",
        "\mcp_server\server.py"
      ],
      "transportType": "stdio",
      "disabled": true
    }
  }
}

stdio実行方式

# api_serverディレクトリに移動
python main.py
# APIサービスを起動

# clineのcfgを設定した後
# clineでmcp serverをテスト

2つ目はsse方式

uviconを使用してサービスを生成し、clineプラグインのremote server方式で設定して接続します。 主な機能はremote_server.pyに含まれており、以下にclineのcfg設定を示します。

{
  "mcpServers": {
    "calculate": {
      "autoApprove": [
        "calculate_sum",
        "calculate_subtract",
        "calculate_multiply",
        "calculate_divide"
      ],
      "disabled": false,
      "timeout": 60,
      "url": "http://127.0.0.1:8001/sse",
      "transportType": "sse"
    }
  }
}

sse実行方式

# api_serverディレクトリに移動
python main.py
# APIサービスを起動

# mcp_serverディレクトリに移動
python remote_server.py
# mcp serverを起動

# clineのcfgを設定した後
# clineでmcp serverをテスト

🌟 システムアーキテクチャ

graph LR
    Client-->|SSE ストリーミング転送| MCP_Server["MCP Server (Port 8001)"]
    MCP_Server-->|HTTP RPC| API_Server["API Server (Port 8000)"]
    API_Server-.->|関数呼び出し| FUNC[(計算関数)]
    
    subgraph 計算サービス
        API_Server
    end

✨ 主な機能

• 🧮 四則演算ツールセット（加減乗除）
• 📡 SSEに基づくリアルタイムメッセージ転送
• ⚡ 非同期HTTPクライアントサポート
• 🔒 強い型入力検証

🔧 技術詳細

🚀 クイックスタート

前提条件

• Python 3.10+

依存関係のインストール

pip install fastapi uvicorn pytest

プロジェクトの実行

1. APIサービスを起動する（api_serverディレクトリで）

cd api_server && python main.py

2. MCP Serverを起動する（mcp_serverディレクトリで）

cd mcp_server && python remote_server.py

3. clineプラグインを設定してテストを行う