Mcpproxy

🚀 MCP SSE 代理サーバー

MCP SSE 代理サーバーは、SSE（Server-Sent Events）プロトコルをベースにした MCP プロトコルの代理サーバーです。共有および独立したセッションモードをサポートし、柔軟な設定オプションを提供し、CURSOR 環境との統合も可能です。

🚀 クイックスタート

インストール

pip install mcp-sse-server

サーバーの起動

python3 -m mcp.sse_server.run_sse_server --listen "127.0.0.1" --port 8000 --auth_key your_auth_key_here

✨ 主な機能

• 基本機能：MCP プロトコルの代理サーバー機能を提供し、SSE（Server-Sent Events）伝送プロトコルをサポートします。
• アーキテクチャモード：
  • 共有セッションモード：複数のクライアントが同じコンテキストデータを共有できます。
  • 独立セッションモード：各クライアントは独立したコンテキストデータを持ちます。
• 動的設定：
  • URL パラメータを介した環境変数の渡しをサポートします。
  • 使いやすい設定方法を提供します。
• 接続能力：
  • ツール実行環境に直接接続できます。
  • CURSOR プロトコルの統合をサポートします。

📦 インストール

ローカルインストール

pip install mcp-sse-server

高度なインストール

# 例：仮想環境を使用してインストールする
python3 -m venv mcp_env && \
source mcp_env/bin/activate && \
pip install mcp-sse-server

💻 使用例

基本的な使用法

# 例：ローカルで MCP SSE サーバーを実行する
python3 -m mcp.sse_server.run_sse_server --listen "::1" --port 8000 --auth_key your_auth_key_here

高度な使用法

ツール実行

# 例：指定されたツールを持つ MCP サーバーを構成して起動する
python3 -m mcp.sse_server.run_sse_server \
    --listen "0.0.0.0" \
    --port 8000 \
    --auth_key your_auth_key_here \
    --tools 'echo,cat,ls'

CURSOR 統合

# 例：CURSOR 環境の MCP サーバーを構成する
python3 -m mcp.sse_server.run_sse_server \
    --listen "127.0.0.1" \
    --port 8000 \
    --auth_key your_auth_key_here \
    --cursor_mode enable

📚 ドキュメント

設定オプション

接続方法

# 例：curl を使用してサーバーに接続する
curl -X POST "http://127.0.0.1:8000/api" \
  --header "Content-Type: application/json" \
  --data-raw '{"command": "echo", "args": ["hello"]}'

設定例

{
    "server_name": "my_mcp_server",
    "listen_address": "0.0.0.0",
    "port_number": 8000,
    "auth_key": "your_auth_key_here",
    "tools_list": ["echo", "cat", "ls"],
    "cursor_mode": true
}

ログ記録

ログ記録の有効化

# 例：デバッグレベルのログ記録を有効にする
python3 -m mcp.sse_server.run_sse_server \
    --listen "127.0.0.1" \
    --port 8000 \
    --auth_key your_auth_key_here \
    --log_level debug

ログ形式

# 例：カスタムログ出力形式
python3 -m mcp.sse_server.run_sse_server \
    --listen "127.0.0.1" \
    --port 8000 \
    --auth_key your_auth_key_here \
    --log_format "%(asctime)s - %(levelname)s - %(message)s"

エラー処理

一般的なエラー

• 認証失敗：有効な認証キーが正しく構成または渡されていません。
• ポートが使用中：対象のポートは他のプログラムによって使用されています。
• ツールが不足している：指定されたツールがシステムに存在しません。

エラーコード

エラーログ形式

LEVEL TIMESTAMP - MSG

使用制限

• 最大接続数：デフォルトでは20の同時接続をサポートし、設定で拡張できます。
• ツール制限：事前に設定されたツールリストのみをサポートします。

貢献ガイド

• コードリポジトリ：GitHub リポジトリのアドレス
• 問題の報告：Issues セクションに問題と提案を投稿してください。

🔧 技術詳細

セキュリティ機能

• 認証：
  • URL パラメータに基づく認証メカニズムをサポートします。
  • 拡張可能なプラグイン式認証モジュールがあります。
• データ保護：
  • データ伝送は SSL 暗号化を使用し、デフォルトで有効になっています。
  • 柔軟なセキュリティポリシーの設定オプションがあります。

開発環境

• Python バージョン：3.8+
• 依存関係管理：poetry または pipenv を使用します。
• コードスタイル：PEP8 規範に従います。

貢献フロー

1. リポジトリを個人アカウントに Fork します。
2. 機能ブランチを作成します。
3. コードをコミットし、リモートリポジトリに Push します。
4. Pull Request を提出します。

テスト

単体テスト

pytest tests/unit/ -v

統合テスト

pytest tests/integration/ -v

パフォーマンステスト

loadtest.py -c 100 -p 8000

デプロイ

本番環境の設定

• リバースプロキシ：Nginx または Apache の使用をおすすめします。
• SSL 証明書：HTTPS を有効にする必要があります。
• ログ管理：集中化されたログ収集サービスを設定します。

監視方案

• 状態監視：定期的にサービスの実行状態を確認します。
• パフォーマンス指標：CPU、メモリの使用状況を監視します。
• エラーアラート：エラー閾値を設定してアラートをトリガーします。

📄 ライセンス

MIT License

プロジェクト情報

• バージョン情報：1.0.0

将来の機能

• 拡張プラグインのサポート
• 多プロトコル互換性
• 高度なセキュリティ機能

ログ例

起動ログ

INFO: Server started on port 8000 at address ::1
DEBUG: Loaded tools: ['echo', 'cat', 'ls']

リクエストログ

INFO: Received request from 127.0.0.1:55556
DEBUG: Command received: echo, arguments: ["hello"]
INFO: Completed command execution in 0.002 seconds

エラーログ

ERROR: Authentication failed for request from 192.168.1.1:45678
CRITICAL: Server shutting down due to repeated authentication failures