MCP Command Server

🚀 MCPコマンドラインサーバ

MCPコマンドラインサーバは、Rust言語で開発された高度に安全なリモートコマンド実行サービスです。JSON - RPCプロトコルを通じてクライアントと通信し、悪意のある操作を防止するための強力なコマンドフィルタリングシステムを内蔵しています。

🚀 クイックスタート

📦 インストール

Dockerを使用した実行

# イメージの取得
docker pull mcp/command-server:latest

# コンテナの実行
docker run -d --name mcp-server -p 8080:8080 mcp/command-server:latest

ローカルでのビルド

1. プロジェクトリポジトリをクローンします。
2. RustとDocker環境をインストールします。
3. イメージをビルドします。

cargo build && docker build -t mcp/command-server .

✨ 主な機能

JSON - RPCインターフェース

• command.get(params: CommandParams) -> Result<CommandOutput>
  • コマンドを実行し、その出力結果を返します。

コマンドパラメータ構造

リクエストパラメータ

#[derive(serde::Serialize, serde::Deserialize)]
struct CommandParams {
    command: String,
    // オプションパラメータ、完全なエラー情報を表示するかどうか、デフォルトはfalse
    verbose: Option<bool>,
}

レスポンス結果

#[derive(serde::Serialize, serde:: Deserialize)]
struct CommandOutput {
    stdout: String,
    stderr: String,
    exit_code: i32,
}

🔧 技術詳細

セキュリティメカニズム

コマンドフィルタリングシステム

• exclude.yamlファイルを使用して、実行を禁止するコマンドパターンを設定します。

patterns:
    - "rm -rf"
    - regex: "^sudo\s+"
    - shell: "../*.sh"

禁止されるコマンドの分類

1. システム変更系：apt, yum, など
2. ファイル操作系：rm -rf, など
3. システム制御系：shutdown, reboot, など
4. 権限変更系：chmod, sudo, など
5. ネットワーク操作系：wget, curl, など
6. コマンド連鎖実行：&&, |, など
7. スクリプト実行系：bash, python, など
8. ファイルパスの横断：../, など

プロジェクト構造

mcp_command_server/
├── .context                 # APIドキュメントのmarkdown
├── Cargo.toml               # Rustの依存関係管理
├── Dockerfile               # マルチステージのDockerビルドファイル
├── exclude.yaml             # コマンドフィルタリングの設定
├── docker-compose.yml       # Docker Composeの設定
├── src/
│   ├── main.rs              # サービスのメインプログラム
│   ├── command.rs           # コマンド実行のロジック
│   ├── rpc.rs               # JSON - RPC処理モジュール
│   └── validator.rs         # コマンド検証のロジック
└── docs/
    ├── README.md            # ドキュメントの説明
    └── mcp_command_server.postman_collection.json  # Postmanのテストコレクション

開発ガイド

依存関係

• Rust: 主要なプログラミング言語
• tokio: 非同期ランタイム
• warp: Webサーバフレームワーク
• serde & serde_json: シリアライズ/デシリアライズライブラリ
• serde_yaml: YAMLファイル解析
• regex: 正規表現のサポート

貢献ガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add some amazing feature')。
4. リモートブランチにプッシュします (git push origin feature/amazing-feature)。
5. Pull Requestを提出します。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルを参照してください。

連絡先

• メール：support@mcp.com
• GitHub: https://github.com/mcp/command-server