Mladensu Cli MCP Server

🚀 CLI MCP サーバー

安全なモデルコンテキストプロトコル（MCP）サーバーで、包括的なセキュリティ機能を備え、コマンドライン操作を制御下で実行できます。

🚀 クイックスタート

このCLI MCPサーバーは、制御された環境でコマンドライン操作を実行し、包括的なセキュリティ保護と詳細なエラーハンドリングを提供します。

✨ 主な機能

• コマンドホワイトリストの適用
• オプションの検証
• パストラバーサルの防止
• Shell演算子のブロック
• コマンド長の制限
• 実行タイムアウト
• 作業ディレクトリの制限

📦 インストール

開発/未公開サーバーの設定

uv sync
uv build --dev

公開済みサーバーの設定

uv sync
uv build
uv publish --token {{YOUR_PYPI_API_TOKEN}}

📚 ドキュメント

設定

以下はサーバーの環境変数設定です：

利用可能なツール

run_command

• 入力形式:

  {
    "command": string,
    "arguments": array<string>,
    "stdin": string,
    "stdout": boolean,
    "stderr": boolean
  }
  

• 出力形式:

  {
    "exit_code": number,
    "stdout": string | null,
    "stderr": string | null,
    "error": string | null
  }
  

show_security_rules

• 入力形式: なし。
• 出力形式: 現在のすべてのセキュリティルールと設定をリスト表示します。

セキュリティ機能

• コマンドホワイトリストの適用
• オプションの検証
• パストラバーサルの防止
• Shell演算子のブロック
• コマンド長の制限
• 実行タイムアウト
• 作業ディレクトリの制限

エラーハンドリング

サーバーは詳細なエラーメッセージを提供します。以下のようなエラーが含まれます：

• セキュリティ違反
• コマンドタイムアウト
• 無効なコマンド形式
• パスセキュリティ違反
• 実行失敗

開発

前提条件

• Python 3.10+
• MCP プロトコルライブラリ

ビルドと公開

1. 依存関係を同期し、ロックファイルを更新します：

   uv sync
   

2. リリース版をビルドします：

   uv build
   

   これにより、dist/ ディレクトリにソースコードとホイールファイルが作成されます。

3. PyPIに公開します：

   uv publish --token {{YOUR_PYPI_API_TOKEN}}
   

デバッグ

MCPサーバーは標準入力/出力で動作するため、デバッグは難しい場合があります。MCP Inspectorの使用を強くおすすめします。

以下のコマンドでInspectorを起動できます：

npx @modelcontextprotocol/inspector uv --directory {{your source code local directory}}/cli-mcp-server run cli-mcp-server

起動後、InspectorはブラウザでアクセスできるURLを表示し、デバッグを開始できます。

📄 ライセンス

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

もし追加の質問やサポートが必要な場合は、プロジェクトリポジトリで問題を開いてください。