[{"_1":2,"_323":-5,"_324":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_247":248},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"BOT","id",6151266,"membership","referenceId","0196b344-dcde-7422-996f-96e6055faaa8","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_68":-5,"_69":28,"_29":70,"_165":166,"_245":246},"availableLocales",[28,40,47,54,61],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","A Model Context Protocol server that allows secure execution of pre-approved commands, enabling AI assistants to safely interact with the user's system.","name","Command Executor MCP Server","readme","

\n\n# command-executor MCP Server\n\n $\"Command$ \n \n $\"EN$ \n $\"JA$ \n

\n\nA Model Context Protocol server for executing pre-approved commands securely.\n\n## 🎥 Demo\n\nhttps://github.com/user-attachments/assets/ed763a12-b685-4e0b-b9a5-bc948a590f51\n\n## ✨ Features\n\n- Secure command execution with pre-approved command list\n- Configurable allowed commands through environment variables\n- Built with TypeScript and MCP SDK\n- Communication via stdio for seamless integration\n- Error handling and security validations\n- Real-time command output streaming\n\n## 🚀 Installation\n\nInstall dependencies:\n```bash\nnpm install\n```\n\nBuild the server:\n```bash\nnpm run build\n```\n\nFor development with auto-rebuild:\n```bash\nnpm run watch\n```\n\n## ⚙️ Configuration\n\n### 🔒 Allowed Commands\n\nBy default, the following commands are allowed:\n- git\n- ls\n- mkdir\n- cd\n- npm\n- npx\n- python\n\nYou can customize the allowed commands by setting the `ALLOWED_COMMANDS` environment variable:\n\n```bash\nexport ALLOWED_COMMANDS=git,ls,mkdir,python\n```\n\n### 🔌 Claude Desktop Integration\n\nTo use with Claude Desktop, add the server config:\n\nOn MacOS:\n```bash\n~/Library/Application Support/Claude/claude_desktop_config.json\n```\n\nOn Windows:\n```\n%APPDATA%/Claude/claude_desktop_config.json\n```\n\nConfiguration example:\n```json\n{\n \"mcpServers\": {\n \"command-executor\": {\n \"command\": \"/path/to/command-executor/build/index.js\"\n }\n }\n}\n```\n\n## 🛡️ Security Considerations\n\nThe command-executor server implements several security measures:\n\n1. Pre-approved Command List\n - Only explicitly allowed commands can be executed\n - Default list is restrictive and security-focused\n - Commands are validated by prefix to prevent injection\n\n2. Command Validation\n - Command prefix validation prevents command injection\n - No shell execution for improved security\n - Environment variables are properly sanitized\n\n3. Error Handling\n - Comprehensive error handling for unauthorized commands\n - Clear error messages for debugging\n - Failed commands don't crash the server\n\n4. Environment Isolation\n - Server runs in its own environment\n - Environment variables can be controlled\n - Limited system access\n\n## 💻 Development\n\n### 📁 Project Structure\n\n```\ncommand-executor/\n├─ src/\n│ └─ index.ts # Main server implementation\n├─ build/\n│ └─ index.js # Compiled JavaScript\n├─ assets/\n│ └─ header.svg # Project header image\n└─ package.json # Project configuration\n```\n\n### 🐛 Debugging\n\nSince MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):\n\n```bash\nnpm run inspector\n```\n\nThe Inspector will provide a URL to access debugging tools in your browser.\n\n## 🛠️ Tool API\n\nThe server provides a single tool:\n\n### execute_command\n\nExecutes a pre-approved command.\n\nParameters:\n- `command` (string, required): The command to execute\n\nExample Request:\n```json\n{\n \"name\": \"execute_command\",\n \"arguments\": {\n \"command\": \"git status\"\n }\n}\n```\n\nExample Response:\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"On branch main\\nNothing to commit, working tree clean\"\n }\n ]\n}\n```\n\nError Response:\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Command execution failed: Command not allowed\"\n }\n ],\n \"isError\": true\n}\n```\n\n## ❌ Error Handling\n\nThe server provides detailed error messages for various scenarios:\n\n1. Unauthorized Commands\n ```json\n {\n \"code\": \"InvalidParams\",\n \"message\": \"Command not allowed: [command]. Allowed commands: git, ls, mkdir, cd, npm, npx, python\"\n }\n ```\n\n2. Execution Failures\n ```json\n {\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Command execution failed: [error message]\"\n }\n ],\n \"isError\": true\n }\n ```\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch\n3. Commit your changes\n4. Push to the branch\n5. Create a new Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","English","tag","en-US",{"_29":41,"_33":45,"_38":46},{"_31":42,"_33":43,"_35":44},"Un servidor de protocolo de contexto de modelo que permite la ejecución segura de comandos previamente aprobados, lo que permite que los asistentes de IA interactúen de forma segura con el sistema del usuario.","Servidor MCP del ejecutor de comandos","# Servidor MCP ejecutor de comandos\n\nUn servidor de protocolo de contexto modelo para ejecutar comandos previamente aprobados de forma segura.\n\n## 🎥 Demostración\n\n\n\n## ✨ Características\n\n* Ejecución segura de comandos con una lista de comandos previamente aprobada\n* Comandos permitidos configurables a través de variables de entorno\n* Desarrollado con TypeScript y MCP SDK\n* Comunicación a través de stdio para una integración perfecta\n* Manejo de errores y validaciones de seguridad\n* Transmisión de salida de comandos en tiempo real\n\n## 🚀 Instalación\n\nInstalar dependencias:\n\n```bash\nnpm install\n```\n\nConstruir el servidor:\n\n```bash\nnpm run build\n```\n\nPara desarrollo con reconstrucción automática:\n\n```bash\nnpm run watch\n```\n\n## ⚙️ Configuración\n\n### 🔒 Comandos permitidos\n\nDe forma predeterminada, se permiten los siguientes comandos:\n\n* git\n* es\n* mkdir\n* cd\n* npm\n* npx\n* pitón\n\nPuede personalizar los comandos permitidos configurando la variable de entorno `ALLOWED_COMMANDS` :\n\n```bash\nexport ALLOWED_COMMANDS=git,ls,mkdir,python\n```\n\n### 🔌 Integración de escritorio de Claude\n\nPara utilizar con Claude Desktop, agregue la configuración del servidor:\n\nEn MacOS:\n\n```bash\n~/Library/Application Support/Claude/claude_desktop_config.json\n```\n\nEn Windows:\n\n```\n%APPDATA%/Claude/claude_desktop_config.json\n```\n\nEjemplo de configuración:\n\n```json\n{\n \"mcpServers\": {\n \"command-executor\": {\n \"command\": \"/path/to/command-executor/build/index.js\"\n }\n }\n}\n```\n\n## 🛡️ Consideraciones de seguridad\n\nEl servidor ejecutor de comandos implementa varias medidas de seguridad:\n\n1. Lista de comandos preaprobada\n\n * Sólo se pueden ejecutar comandos explícitamente permitidos\n * La lista predeterminada es restrictiva y se centra en la seguridad.\n * Los comandos se validan mediante prefijo para evitar la inyección.\n\n2. Validación de comandos\n\n * La validación del prefijo de comando evita la inyección de comandos\n * No se ejecuta el shell para mejorar la seguridad\n * Las variables de entorno se desinfectan adecuadamente\n\n3. Manejo de errores\n\n * Manejo integral de errores para comandos no autorizados\n * Borrar mensajes de error para depuración\n * Los comandos fallidos no bloquean el servidor\n\n4. Aislamiento ambiental\n\n * El servidor se ejecuta en su propio entorno\n * Las variables de entorno se pueden controlar\n * Acceso limitado al sistema\n\n## 💻 Desarrollo\n\n### 📁 Estructura del proyecto\n\n```\ncommand-executor/\n├─ src/\n│ └─ index.ts # Main server implementation\n├─ build/\n│ └─ index.js # Compiled JavaScript\n├─ assets/\n│ └─ header.svg # Project header image\n└─ package.json # Project configuration\n```\n\n### 🐛 Depuración\n\nDado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el [Inspector MCP](https://github.com/modelcontextprotocol/inspector) :\n\n```bash\nnpm run inspector\n```\n\nEl Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.\n\n## 🛠️ API de herramientas\n\nEl servidor proporciona una única herramienta:\n\n### ejecutar\\_comando\n\nEjecuta un comando previamente aprobado.\n\nParámetros:\n\n* `command` (cadena, obligatorio): el comando a ejecutar\n\nEjemplo de solicitud:\n\n```json\n{\n \"name\": \"execute_command\",\n \"arguments\": {\n \"command\": \"git status\"\n }\n}\n```\n\nEjemplo de respuesta:\n\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"On branch main\\nNothing to commit, working tree clean\"\n }\n ]\n}\n```\n\nRespuesta de error:\n\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Command execution failed: Command not allowed\"\n }\n ],\n \"isError\": true\n}\n```\n\n## ❌ Manejo de errores\n\nEl servidor proporciona mensajes de error detallados para varios escenarios:\n\n1. Comandos no autorizados\n\n ```json\n {\n \"code\": \"InvalidParams\",\n \"message\": \"Command not allowed: [command]. Allowed commands: git, ls, mkdir, cd, npm, npx, python\"\n }\n ```\n\n2. Fallos de ejecución\n\n ```json\n {\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Command execution failed: [error message]\"\n }\n ],\n \"isError\": true\n }\n ```\n\n## 🤝 Contribuyendo\n\n1. Bifurcar el repositorio\n2. Crea tu rama de funciones\n3. Confirme sus cambios\n4. Empujar hacia la rama\n5. Crear una nueva solicitud de extracción\n\n## 📄 Licencia\n\nEste proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.","Spanish","es-ES",{"_29":48,"_33":52,"_38":53},{"_31":49,"_33":50,"_35":51},"事前に承認されたコマンドの安全な実行を可能にし、AI アシスタントがユーザーのシステムと安全に対話できるようにするモデルコンテキストプロトコルサーバー。","コマンドエグゼキュータMCPサーバー","# コマンド実行者 MCP サーバー\n\n事前に承認されたコマンドを安全に実行するためのモデルコンテキストプロトコルサーバー。\n\n## 🎥 デモ\n\n\n\n## ✨ 特徴\n\n* 事前承認されたコマンドリストによる安全なコマンド実行\n* 環境変数を通じて許可されるコマンドを設定可能\n* TypeScriptとMCP SDKで構築\n* シームレスな統合のためのstdio経由の通信\n* エラー処理とセキュリティ検証\n* リアルタイムコマンド出力ストリーミング\n\n## 🚀 インストール\n\n依存関係をインストールします:\n\n```bash\nnpm install\n```\n\nサーバーを構築します。\n\n```bash\nnpm run build\n```\n\n自動リビルドを使用した開発の場合:\n\n```bash\nnpm run watch\n```\n\n## ⚙️ 構成\n\n### 🔒 許可されたコマンド\n\nデフォルトでは、次のコマンドが許可されます。\n\n* ギット\n* ls\n* mkdir\n* CD\n* npm\n* npx\n* パイソン\n\n`ALLOWED_COMMANDS`環境変数を設定することで、許可されるコマンドをカスタマイズできます。\n\n```bash\nexport ALLOWED_COMMANDS=git,ls,mkdir,python\n```\n\n### 🔌 クロードデスクトップ統合\n\nClaude Desktop で使用するには、サーバー設定を追加します。\n\nMacOSの場合:\n\n```bash\n~/Library/Application Support/Claude/claude_desktop_config.json\n```\n\nWindowsの場合:\n\n```\n%APPDATA%/Claude/claude_desktop_config.json\n```\n\n設定例:\n\n```json\n{\n \"mcpServers\": {\n \"command-executor\": {\n \"command\": \"/path/to/command-executor/build/index.js\"\n }\n }\n}\n```\n\n## 🛡️ セキュリティに関する考慮事項\n\nコマンド実行サーバーは、いくつかのセキュリティ対策を実装しています。\n\n1. 事前承認済みコマンドリスト\n\n * 明示的に許可されたコマンドのみ実行できます\n * デフォルトのリストは制限的でセキュリティに重点を置いています\n * コマンドはプレフィックスによって検証され、インジェクションを防止します\n\n2. コマンド検証\n\n * コマンドプレフィックス検証によりコマンドインジェクションを防止\n * セキュリティ強化のためシェル実行なし\n * 環境変数は適切にサニタイズされている\n\n3. エラー処理\n\n * 不正なコマンドに対する包括的なエラー処理\n * デバッグのためにエラーメッセージをクリアする\n * 失敗したコマンドはサーバーをクラッシュさせません\n\n4. 環境分離\n\n * サーバーは独自の環境で実行されます\n * 環境変数を制御できる\n * システムアクセスの制限\n\n## 💻 開発\n\n### 📁 プロジェクト構造\n\n```\ncommand-executor/\n├─ src/\n│ └─ index.ts # Main server implementation\n├─ build/\n│ └─ index.js # Compiled JavaScript\n├─ assets/\n│ └─ header.svg # Project header image\n└─ package.json # Project configuration\n```\n\n### 🐛 デバッグ\n\nMCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。MCP [Inspectorの](https://github.com/modelcontextprotocol/inspector)使用をお勧めします。\n\n```bash\nnpm run inspector\n```\n\nインスペクターは、ブラウザでデバッグツールにアクセスするための URL を提供します。\n\n## 🛠️ ツールAPI\n\nサーバーは次の単一のツールを提供します:\n\n### 実行コマンド\n\n事前に承認されたコマンドを実行します。\n\nパラメータ:\n\n* `command` (文字列、必須): 実行するコマンド\n\nリクエスト例:\n\n```json\n{\n \"name\": \"execute_command\",\n \"arguments\": {\n \"command\": \"git status\"\n }\n}\n```\n\n応答例:\n\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"On branch main\\nNothing to commit, working tree clean\"\n }\n ]\n}\n```\n\nエラー応答:\n\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Command execution failed: Command not allowed\"\n }\n ],\n \"isError\": true\n}\n```\n\n## ❌ エラー処理\n\nサーバーは、さまざまなシナリオに対して詳細なエラーメッセージを提供します。\n\n1. 不正なコマンド\n\n ```json\n {\n \"code\": \"InvalidParams\",\n \"message\": \"Command not allowed: [command]. Allowed commands: git, ls, mkdir, cd, npm, npx, python\"\n }\n ```\n\n2. 実行失敗\n\n ```json\n {\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Command execution failed: [error message]\"\n }\n ],\n \"isError\": true\n }\n ```\n\n## 🤝 貢献する\n\n1. リポジトリをフォークする\n2. 機能ブランチを作成する\n3. 変更をコミットする\n4. ブランチにプッシュする\n5. 新しいプルリクエストを作成する\n\n## 📄 ライセンス\n\nこのプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。","Japanese","ja-JP",{"_29":55,"_33":59,"_38":60},{"_31":56,"_33":57,"_35":58},"사전 승인된 명령을 안전하게 실행할 수 있는 모델 컨텍스트 프로토콜 서버로, AI 보조자가 사용자 시스템과 안전하게 상호 작용할 수 있도록 지원합니다.","명령 실행기 MCP 서버","# 명령 실행자 MCP 서버\n\n사전 승인된 명령을 안전하게 실행하기 위한 모델 컨텍스트 프로토콜 서버입니다.\n\n## 🎥 데모\n\n\n\n## ✨ 특징\n\n* 사전 승인된 명령 목록을 통한 안전한 명령 실행\n* 환경 변수를 통해 구성 가능한 허용 명령\n* TypeScript 및 MCP SDK로 구축됨\n* 원활한 통합을 위한 stdio를 통한 통신\n* 오류 처리 및 보안 검증\n* 실시간 명령 출력 스트리밍\n\n## 🚀 설치\n\n종속성 설치:\n\n지엑스피1\n\n서버를 빌드하세요:\n\n```bash\nnpm run build\n```\n\n자동 재빌드를 사용한 개발의 경우:\n\n```bash\nnpm run watch\n```\n\n## ⚙️ 구성\n\n### 🔒 허용된 명령어\n\n기본적으로 다음 명령이 허용됩니다.\n\n* git\n* 엘에스\n* mkdir\n* CD\n* 엔피엠\n* 엔피엑스\n* 파이썬\n\n`ALLOWED_COMMANDS` 환경 변수를 설정하여 허용되는 명령을 사용자 정의할 수 있습니다.\n\n```bash\nexport ALLOWED_COMMANDS=git,ls,mkdir,python\n```\n\n### 🔌 Claude 데스크톱 통합\n\nClaude Desktop과 함께 사용하려면 서버 구성을 추가하세요.\n\nMacOS의 경우:\n\n```bash\n~/Library/Application Support/Claude/claude_desktop_config.json\n```\n\nWindows의 경우:\n\n```\n%APPDATA%/Claude/claude_desktop_config.json\n```\n\n구성 예:\n\n```json\n{\n \"mcpServers\": {\n \"command-executor\": {\n \"command\": \"/path/to/command-executor/build/index.js\"\n }\n }\n}\n```\n\n## 🛡️ 보안 고려 사항\n\n명령 실행 서버는 여러 가지 보안 조치를 구현합니다.\n\n1. 사전 승인된 명령 목록\n\n * 명시적으로 허용된 명령만 실행할 수 있습니다.\n * 기본 목록은 제한적이고 보안에 중점을 둡니다.\n * 명령은 주입을 방지하기 위해 접두사로 검증됩니다.\n\n2. 명령 검증\n\n * 명령어 접두사 검증으로 명령어 주입이 방지됩니다.\n * 보안 강화를 위해 셸 실행 없음\n * 환경 변수가 적절하게 정리되었습니다.\n\n3. 오류 처리\n\n * 허가되지 않은 명령에 대한 포괄적인 오류 처리\n * 디버깅을 위한 오류 메시지 지우기\n * 실패한 명령으로 인해 서버가 충돌하지 않습니다.\n\n4. 환경 격리\n\n * 서버는 자체 환경에서 실행됩니다.\n * 환경 변수를 제어할 수 있습니다\n * 제한된 시스템 접근\n\n## 💻 개발\n\n### 📁 프로젝트 구조\n\n```\ncommand-executor/\n├─ src/\n│ └─ index.ts # Main server implementation\n├─ build/\n│ └─ index.js # Compiled JavaScript\n├─ assets/\n│ └─ header.svg # Project header image\n└─ package.json # Project configuration\n```\n\n### 🐛 디버깅\n\nMCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. [MCP Inspector](https://github.com/modelcontextprotocol/inspector) 사용을 권장합니다.\n\n```bash\nnpm run inspector\n```\n\n검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.\n\n## 🛠️ 도구 API\n\n서버는 단일 도구를 제공합니다.\n\n### 실행 명령\n\n미리 승인된 명령을 실행합니다.\n\n매개변수:\n\n* `command` (문자열, 필수): 실행할 명령\n\n요청 예시:\n\n```json\n{\n \"name\": \"execute_command\",\n \"arguments\": {\n \"command\": \"git status\"\n }\n}\n```\n\n응답 예시:\n\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"On branch main\\nNothing to commit, working tree clean\"\n }\n ]\n}\n```\n\n오류 응답:\n\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Command execution failed: Command not allowed\"\n }\n ],\n \"isError\": true\n}\n```\n\n## ❌ 오류 처리\n\n서버는 다양한 시나리오에 대한 자세한 오류 메시지를 제공합니다.\n\n1. 허가되지 않은 명령\n\n ```json\n {\n \"code\": \"InvalidParams\",\n \"message\": \"Command not allowed: [command]. Allowed commands: git, ls, mkdir, cd, npm, npx, python\"\n }\n ```\n\n2. 실행 실패\n\n ```json\n {\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Command execution failed: [error message]\"\n }\n ],\n \"isError\": true\n }\n ```\n\n## 🤝 기여하기\n\n1. 저장소를 포크하세요\n2. 기능 브랜치를 생성하세요\n3. 변경 사항을 커밋하세요\n4. 지점으로 밀어 넣기\n5. 새로운 풀 리퀘스트 만들기\n\n## 📄 라이센스\n\n이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.","Korean","ko-KR",{"_29":62,"_33":66,"_38":67},{"_31":63,"_33":64,"_35":65},"模型上下文协议服务器允许安全执行预先批准的命令，使人工智能助手能够安全地与用户的系统交互。","命令执行器 MCP 服务器","# 命令执行器 MCP 服务器\n\n用于安全地执行预先批准的命令的模型上下文协议服务器。\n\n## 🎥 演示\n\n\n\n## ✨ 特点\n\n* 使用预先批准的命令列表来确保命令执行的安全\n* 通过环境变量配置允许的命令\n* 使用 TypeScript 和 MCP SDK 构建\n* 通过 stdio 进行通信，实现无缝集成\n* 错误处理和安全验证\n* 实时命令输出流\n\n## 🚀 安装\n\n安装依赖项：\n\n```bash\nnpm install\n```\n\n构建服务器：\n\n```bash\nnpm run build\n```\n\n对于使用自动重建的开发：\n\n```bash\nnpm run watch\n```\n\n## ⚙️ 配置\n\n### 🔒 允许的命令\n\n默认情况下，允许以下命令：\n\n* git\n* ls\n* mkdir\n* 光盘\n* npm\n* NPX\n* Python\n\n您可以通过设置`ALLOWED_COMMANDS`环境变量来自定义允许的命令：\n\n```bash\nexport ALLOWED_COMMANDS=git,ls,mkdir,python\n```\n\n### 🔌 Claude 桌面集成\n\n要与 Claude Desktop 一起使用，请添加服务器配置：\n\n在 MacOS 上：\n\n```bash\n~/Library/Application Support/Claude/claude_desktop_config.json\n```\n\n在 Windows 上：\n\n```\n%APPDATA%/Claude/claude_desktop_config.json\n```\n\n配置示例：\n\n```json\n{\n \"mcpServers\": {\n \"command-executor\": {\n \"command\": \"/path/to/command-executor/build/index.js\"\n }\n }\n}\n```\n\n## 🛡️ 安全注意事项\n\n命令执行器服务器实现了多项安全措施：\n\n1. 预先批准的命令列表\n\n * 只能执行明确允许的命令\n * 默认列表具有限制性且注重安全性\n * 通过前缀验证命令以防止注入\n\n2. 命令验证\n\n * 命令前缀验证可防止命令注入\n * 无需执行任何 shell，安全性更高\n * 环境变量已正确清理\n\n3. 错误处理\n\n * 针对未经授权的命令的全面错误处理\n * 清除错误信息以便调试\n * 失败的命令不会导致服务器崩溃\n\n4. 环境隔离\n\n * 服务器在其自己的环境中运行\n * 环境变量可以控制\n * 限制系统访问\n\n## 💻 开发\n\n### 📁 项目结构\n\n```\ncommand-executor/\n├─ src/\n│ └─ index.ts # Main server implementation\n├─ build/\n│ └─ index.js # Compiled JavaScript\n├─ assets/\n│ └─ header.svg # Project header image\n└─ package.json # Project configuration\n```\n\n### 🐛 调试\n\n由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。我们建议使用[MCP Inspector](https://github.com/modelcontextprotocol/inspector) ：\n\n```bash\nnpm run inspector\n```\n\n检查器将提供一个 URL 来访问浏览器中的调试工具。\n\n## 🛠️ 工具 API\n\n服务器提供一个单一工具：\n\n### 执行命令\n\n执行预先批准的命令。\n\n参数：\n\n* `command` （字符串，必需）：要执行的命令\n\n示例请求：\n\n```json\n{\n \"name\": \"execute_command\",\n \"arguments\": {\n \"command\": \"git status\"\n }\n}\n```\n\n响应示例：\n\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"On branch main\\nNothing to commit, working tree clean\"\n }\n ]\n}\n```\n\n错误响应：\n\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Command execution failed: Command not allowed\"\n }\n ],\n \"isError\": true\n}\n```\n\n## ❌错误处理\n\n服务器针对各种场景提供了详细的错误消息：\n\n1. 未经授权的命令\n\n ```json\n {\n \"code\": \"InvalidParams\",\n \"message\": \"Command not allowed: [command]. Allowed commands: git, ls, mkdir, cd, npm, npx, python\"\n }\n ```\n\n2. 执行失败\n\n ```json\n {\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Command execution failed: [error message]\"\n }\n ],\n \"isError\": true\n }\n ```\n\n## 🤝 贡献\n\n1. 分叉存储库\n2. 创建你的功能分支\n3. 提交你的更改\n4. 推送到分支\n5. 创建新的 Pull 请求\n\n## 📄 许可证\n\n该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。","Chinese","zh-CN","githubUser","locale",{"_71":72,"_73":74,"_13":87,"_96":32,"_97":32,"_98":99,"_102":103,"_124":-5,"_16":125,"_126":127,"_128":129,"_33":34,"_130":116,"_131":132,"_136":-5,"_137":138,"_139":-5,"_140":141,"_147":-5,"_148":112,"_149":-5,"_150":151,"_117":162,"_163":164},"addedAt",["D",1741480306821],"argumentsJsonSchema",{"_75":76,"_84":85,"_82":86},"properties",{"_77":78},"ALLOWED_COMMANDS",{"_79":80,"_31":81,"_82":83},"default","git,ls,mkdir,cd,npm,npx,python","Comma-separated list of allowed commands that can be executed by the server","type","string","required",[],"object",[88,89,90,91,92,93,94,95],"category:shell-access","category:code-execution","category:command-line","environment:local","language:javascript","security_grade:a","quality_grade:a","license_grade:f","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":36,"_100":101},"url","https://github.com/Sunwood-ai-labs/command-executor-mcp-server","githubRepository",{"_104":105,"_106":107,"_108":109,"_110":111,"_33":112,"_113":114,"_119":120,"_121":-5,"_122":123},"defaultBranch","master","fullName","Sunwood-ai-labs/command-executor-mcp-server","githubTreeId",74215,"language","JavaScript","command-executor-mcp-server","owner",{"_115":116,"_117":118},"login","Sunwood-ai-labs","uid","se5dujplai","recentStargazers",1,"spdxLicense","stargazers",18,"glamaJson",1565,"inspectable",true,"integrations",[],"namespace","npmPackage",{"_33":133,"_134":135},"command-executor","weeklyDownloads",3,"prompts","redditPostForeignId","1j6w14b","resources","scores",{"_142":143,"_144":145,"_146":145},"license",0,"quality",100,"security","simpleIcon","slug","supportedPlatforms","tools",[152],{"_33":153,"_31":154,"_155":156},"execute_command","事前に許可されたコマンドを実行します","inputSchema",{"_82":86,"_84":157,"_75":159},[158],"command",{"_158":160},{"_82":83,"_31":161},"実行するコマンド","db23ll92j5","updatedAt",["D",1742585746546],"meta",[167,170,172,179,182,184,187,190,193,196,199,201,204,207,209,211,213,215,217],{"_168":169},"title","Command Executor MCP Server | Glama",{"_171":32,"_33":31},"content",{"_173":174,"_175":176,"_177":178},"href","https://glama.ai/mcp/servers/@Sunwood-ai-labs/command-executor-mcp-server","rel","canonical","tagName","link",{"_171":34,"_180":181},"property","og:title",{"_171":32,"_180":183},"og:description",{"_171":185,"_180":186},"https://glama.ai/logo.png","og:logo",{"_171":188,"_180":189},"https://glama.ai/mcp/servers/@Sunwood-ai-labs/command-executor-mcp-server/og-image","og:image",{"_171":191,"_180":192},"630","og:image:height",{"_171":194,"_180":195},"1200","og:image:width",{"_171":197,"_180":198},"website","og:type",{"_171":174,"_180":200},"og:url",{"_171":202,"_180":203},"Glama – MCP Hosting Platform","og:site_name",{"_171":205,"_33":206},"summary_large_image","twitter:card",{"_171":202,"_33":208},"twitter:title",{"_171":32,"_33":210},"twitter:description",{"_171":188,"_33":212},"twitter:image",{"_171":191,"_33":214},"twitter:image:height",{"_171":194,"_33":216},"twitter:image:width",{"_218":219},"script:ld+json",{"_220":221,"_222":223},"@context","http://schema.org","@graph",[224],{"_220":225,"_226":227,"_228":229},"https://schema.org","@type","BreadcrumbList","itemListElement",[230,236,240,243],{"_226":231,"_232":233,"_33":234,"_235":120},"ListItem","item","https://glama.ai/","Glama","position",{"_226":231,"_232":237,"_33":238,"_235":239},"https://glama.ai/mcp","MCP",2,{"_226":231,"_232":241,"_33":242,"_235":135},"https://glama.ai/mcp/servers","Servers",{"_226":231,"_232":174,"_33":34,"_235":244},4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~branch/~/_route",{"_249":250,"_254":105,"_29":255,"_165":275,"_299":300,"_301":302},"blob",{"_171":251,"_252":253},"node_modules/\nbuild/\n*.log\n.env*\ntasks\ntmp/\nexample/terraform/.terraform\nexample/terraform/.terraform.lock.hcl\nexample/terraform/terraform.tfstate\nexample/terraform/terraform.tfstate.backup\n","fileName",".gitignore","branch",{"_71":256,"_73":257,"_13":261,"_96":32,"_97":32,"_98":262,"_102":263,"_124":-5,"_16":125,"_126":127,"_128":265,"_33":34,"_130":116,"_131":266,"_136":-5,"_137":138,"_139":-5,"_140":267,"_147":-5,"_148":112,"_149":-5,"_150":268,"_117":162,"_163":274},["D",1741480306821],{"_75":258,"_84":260,"_82":86},{"_77":259},{"_79":80,"_31":81,"_82":83},[],[88,89,90,91,92,93,94,95],{"_35":36,"_100":101},{"_104":105,"_106":107,"_108":109,"_110":111,"_33":112,"_113":264,"_119":120,"_121":-5,"_122":123},{"_115":116,"_117":118},[],{"_33":133,"_134":135},{"_142":143,"_144":145,"_146":145},[269],{"_33":153,"_31":154,"_155":270},{"_82":86,"_84":271,"_75":272},[158],{"_158":273},{"_82":83,"_31":161},["D",1742585746546],[276,278,280,282,284,285,286,288,289,290,291,292,293,294,295,296,297,298],{"_168":277},"MCP Server | Glama",{"_171":279,"_33":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_173":281,"_175":176,"_177":178},"https://glama.ai/mcp/servers/@Sunwood-ai-labs/command-executor-mcp-server/blob/master/",{"_171":283,"_180":181},"MCP Server",{"_171":279,"_180":183},{"_171":185,"_180":186},{"_171":287,"_180":189},"https://glama.ai/generated-images/og?title=MCP+Server",{"_171":191,"_180":192},{"_171":194,"_180":195},{"_171":197,"_180":198},{"_171":281,"_180":200},{"_171":202,"_180":203},{"_171":205,"_33":206},{"_171":202,"_33":208},{"_171":279,"_33":210},{"_171":287,"_33":212},{"_171":191,"_33":214},{"_171":194,"_33":216},"path","","treeMembers",[303,306,308,310,312,313,315,317,319,321],{"_299":304,"_82":305},"assets","tree",{"_299":307,"_82":305},"docs",{"_299":309,"_82":305},"example",{"_299":311,"_82":305},"src",{"_299":253,"_82":249},{"_299":314,"_82":249},"package.json",{"_299":316,"_82":249},"package-lock.json",{"_299":318,"_82":249},"README.ja.md",{"_299":320,"_82":249},"README.md",{"_299":322,"_82":249},"tsconfig.json","actionData","errors"]