Mcp Code Executor Server

MCP Code Executor Server

AI エージェントが複数のプログラミング言語のコードを、安全で隔離された環境で実行できる、堅牢な Model Context Protocol（MCP） サーバーです。

---

🚀 概要

MCP Code Executor Server は、統一された MCP ツールエンドポイントを公開することで、AI モデルがさまざまなプログラミングランタイムに接続する方法を標準化します。AI アシスタントは次の操作を行えます。

1. サポート対象の言語でコードを送信します。
2. 制御されたサンドボックス環境でコードを実行します。
3. コンパイルエラーや実行時エラーを含む出力を受け取ります。

---

🔑 主な機能

• 複数言語のサポート：Java、Python、JavaScript、TypeScript、C++。
• 安全な実行：リソース制限（CPU、メモリ、タイムアウト）を設けた隔離コンテナ。
• MCP との統合：クライアントがシームレスに検出できる、仕様に準拠した MCP サーバー。
• 自動コンパイル：Java、C++、TypeScript のコンパイルと実行を処理します。
• 詳細なエラーフィードバック：コンパイル時と実行時の両方のエラーメッセージを返します。
• リソースのクリーンアップ：一時ファイルを自動的に削除し、実行タイムアウトを適用します。

---

📐 アーキテクチャ

MCP Code Executor Server はクライアントサーバーモデルに従います。

• MCP クライアント：このサーバーに接続するプロトコルクライアント。
• MCP サーバー：コード実行ツールを公開する、このアプリケーション。
• サンドボックス化されたランタイム：リクエストごとのコンテナまたは隔離されたプロセス。

---

🏁 はじめに

前提条件

• Java 17+
• Python 3.8+
• Node.js & npm
• g++ またはその他の C++ コンパイラー

ローカル環境のセットアップ

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/mcp-code-executor-server.git
   cd mcp-code-executor-server
   

2. ビルドして実行します：

   # Build the project
   ./mvnw clean package
   
   # Start the server
   ./mvnw spring-boot:run
   

サーバーはデフォルトでポート 8080 をリッスンします。

Docker の使用

隔離環境で実行するには、Docker を使用します。

# Build Docker image
docker build -t mcp-code-executor .

# Run container
docker run -p 8080:8080 mcp-code-executor

または、Docker Compose を使用します。

docker-compose up -d

---

🛠️ MCP クライアントの接続

1. MCP 対応の AI クライアントを起動します。
2. http://localhost:8080 を指定します。
3. code-execution ツールを検出して呼び出します。

MCP リクエストの例：

{
  "language": "python",
  "code": "print('Hello, world!')\nprint('hello again')"
}

---

🤝 貢献

貢献を歓迎します！

---

📄 ライセンス

Apache License 2.0。詳細は LICENSE ファイルを参照してください。