MCP Server Python

🚀 MCP サーバーデモ（Python版）

このリポジトリには、Model Communication Protocol (MCP) サーバーのシンプルなPython実装が含まれています。このサーバーは、MCPサーバーの基本機能を展示するために設計されており、テストや開発目的に使用できます。

サーバーはデフォルトで uvicorn を使用して実行され、ポート 8000 を監視します。サーバーをネットワークに公開するには、sse トランスポートを使用してください。

🚀 クイックスタート

このMCPサーバーのPython版を使うには、まず環境をセットアップし、サーバーを起動してテストを行います。以下に詳細な手順を説明します。

📦 インストール

1. 仮想環境の作成とアクティブ化

Python環境を設定するには、以下のコマンドを実行します。

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

💻 使用例

サーバーの起動

サーバーを起動するには、以下のコマンドを実行します。

python3 server.py

サーバーの動作確認

サーバーがポート 8000 で動作していることを確認するには、以下のコマンドを使用できます。

• アクティブな接続を確認する：

  netstat -n | grep 8000
  

• ポートを占有しているプロセスを確認する：

  lsof -i :8000
  

• curl を使用してサーバーをテストする：

  curl http://0.0.0.0:8000/sse
  

テストの実行

このプロジェクトには pytest を使用した包括的なテストスイートが含まれています。テストを実行するには：

# テスト依存関係をインストールする
pip install -r requirements.txt

# 詳細な出力でテストを実行する
pytest -v

# カバレッジレポートを生成してテストを実行する
pytest --cov=.

テストの範囲

テストスイートには以下の内容が含まれています：

• 基本機能テスト（足し算と引き算）
• 入力検証と型チェック
• 大数の境界条件
• APIエンドポイントテスト（挨拶）

すべてのテストは test_server.py にあり、以下をカバーしています：

• add() 関数
• subtract() 関数
• get_greeting() 関数
• 型エラー処理
• 境界条件処理

ツールでのサーバーの使用

このサーバーをCursorやClaudeなどのツールと統合するには、以下の mcp.json 設定ファイルを使用してください。

{
  "mcpServers": {
    "demo-server": {
      "transport": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

🔧 注意事項

• デフォルトでは、サーバーは stdio トランスポートを使用します。サーバーをネットワークに公開するには、sse トランスポートを使用するように設定してください。
• このサーバーは localhost で実行され、uvicornを使用してポート 8000 を監視します。

何か問題があれば、自由に貢献したり、問題を提起したりしてください！