Skip to main content
Glama
Sign In
enesjakozh

Command Executor MCP Server

by Sunwood-ai-labs
npmGitHub
JavaScript
3
18
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

コマンド実行者 MCP サーバー

事前に承認されたコマンドを安全に実行するためのモデル コンテキスト プロトコル サーバー。

🎥 デモ

https://github.com/user-attachments/assets/ed763a12-b685-4e0b-b9a5-bc948a590f51

✨ 特徴

  • 事前承認されたコマンドリストによる安全なコマンド実行
  • 環境変数を通じて許可されるコマンドを設定可能
  • TypeScriptとMCP SDKで構築
  • シームレスな統合のためのstdio経由の通信
  • エラー処理とセキュリティ検証
  • リアルタイムコマンド出力ストリーミング

🚀 インストール

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

自動リビルドを使用した開発の場合:

npm run watch

⚙️ 構成

🔒 許可されたコマンド

デフォルトでは、次のコマンドが許可されます。

  • ギット
  • ls
  • mkdir
  • CD
  • npm
  • npx
  • パイソン

ALLOWED_COMMANDS環境変数を設定することで、許可されるコマンドをカスタマイズできます。

export ALLOWED_COMMANDS=git,ls,mkdir,python

🔌 クロード デスクトップ統合

Claude Desktop で使用するには、サーバー設定を追加します。

MacOSの場合:

~/Library/Application Support/Claude/claude_desktop_config.json

Windowsの場合:

%APPDATA%/Claude/claude_desktop_config.json

設定例:

{ "mcpServers": { "command-executor": { "command": "/path/to/command-executor/build/index.js" } } }

🛡️ セキュリティに関する考慮事項

コマンド実行サーバーは、いくつかのセキュリティ対策を実装しています。

  1. 事前承認済みコマンドリスト
    • 明示的に許可されたコマンドのみ実行できます
    • デフォルトのリストは制限的でセキュリティに重点を置いています
    • コマンドはプレフィックスによって検証され、インジェクションを防止します
  2. コマンド検証
    • コマンドプレフィックス検証によりコマンドインジェクションを防止
    • セキュリティ強化のためシェル実行なし
    • 環境変数は適切にサニタイズされている
  3. エラー処理
    • 不正なコマンドに対する包括的なエラー処理
    • デバッグのためにエラーメッセージをクリアする
    • 失敗したコマンドはサーバーをクラッシュさせません
  4. 環境分離
    • サーバーは独自の環境で実行されます
    • 環境変数を制御できる
    • システムアクセスの制限

💻 開発

📁 プロジェクト構造

command-executor/ ├─ src/ │ └─ index.ts # Main server implementation ├─ build/ │ └─ index.js # Compiled JavaScript ├─ assets/ │ └─ header.svg # Project header image └─ package.json # Project configuration

🐛 デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。MCP Inspectorの使用をお勧めします。

npm run inspector

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。

🛠️ ツールAPI

サーバーは次の単一のツールを提供します:

実行コマンド

事前に承認されたコマンドを実行します。

パラメータ:

  • command (文字列、必須): 実行するコマンド

リクエスト例:

{ "name": "execute_command", "arguments": { "command": "git status" } }

応答例:

{ "content": [ { "type": "text", "text": "On branch main\nNothing to commit, working tree clean" } ] }

エラー応答:

{ "content": [ { "type": "text", "text": "Command execution failed: Command not allowed" } ], "isError": true }

❌ エラー処理

サーバーは、さまざまなシナリオに対して詳細なエラー メッセージを提供します。

  1. 不正なコマンド
    { "code": "InvalidParams", "message": "Command not allowed: [command]. Allowed commands: git, ls, mkdir, cd, npm, npx, python" }
  2. 実行失敗
    { "content": [ { "type": "text", "text": "Command execution failed: [error message]" } ], "isError": true }

🤝 貢献する

  1. リポジトリをフォークする
  2. 機能ブランチを作成する
  3. 変更をコミットする
  4. ブランチにプッシュする
  5. 新しいプルリクエストを作成する

📄 ライセンス

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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Tools

事前に承認されたコマンドの安全な実行を可能にし、AI アシスタントがユーザーのシステムと安全に対話できるようにするモデル コンテキスト プロトコル サーバー。

  1. 🎥 デモ
    1. ✨ 特徴
      1. 🚀 インストール
        1. ⚙️ 構成
          1. 🔒 許可されたコマンド
          2. 🔌 クロード デスクトップ統合
        2. 🛡️ セキュリティに関する考慮事項
          1. 💻 開発
            1. 📁 プロジェクト構造
            2. 🐛 デバッグ
          2. 🛠️ ツールAPI
            1. 実行コマンド
          3. ❌ エラー処理
            1. 🤝 貢献する
              1. 📄 ライセンス

                Related Resources

                Related MCP Servers

                • MCP Python Toolbox

                  gianlucamazza
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.
                  Last updated -
                  1
                  Python
                  • Linux
                  • Apple

                • Bluesky MCP Server

                  brianellin
                  A
                  security
                  F
                  license
                  A
                  quality
                  A Model Context Protocol server that enables AI assistants to interact with Bluesky/ATProtocol, providing authentication, timeline access, post creation, and social features like likes and follows.
                  Last updated -
                  18
                  10
                  TypeScript
                  • Apple
                  • Linux

                • Tiny TODO MCP

                  tkc
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.
                  Last updated -
                  1
                  TypeScript

                • MCP Toolkit

                  zxfgds
                  -
                  security
                  F
                  license
                  -
                  quality
                  A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
                  Last updated -
                  16
                  TypeScript

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/Sunwood-ai-labs/command-executor-mcp-server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server