Simple Commands MCP

🚀 Simple Commands MCP サーバー

設定駆動型のモデルコンテキストプロトコル（MCP）サーバーで、開発者コマンドの実行と長時間実行プロセスの管理ツールを提供します。このサーバーを使用すると、AIアシスタントが簡単なJSON設定ファイルを通じて事前定義されたコマンドを実行できます。

🚀 クイックスタート

このサーバーは、JSON設定ファイルを通じて開発者コマンドの実行と長時間実行プロセスの管理を可能にします。以下のセクションでは、インストール方法、使用方法、トラブルシューティングなどの詳細を説明します。

✨ 主な機能

• 設定駆動型：JSON設定ファイルを更新するだけで新しいツールを追加できます。
• デーモン管理：自動的な起動、停止、状態確認、ログ取得コマンドで長時間実行プロセスを管理します。
• 自動生成コントロール：各デーモンに自動的に _start、_status、_stop、_logs コマンドが追加されます。
• プロセス監視：すべてのデーモンのPID、稼働時間、状態を追跡し、出力をキャプチャします。
• 自動クリーンアップ：MCPクライアントが切断されると、すべてのプロセスが終了します。
• クロスプラットフォーム：macOS、Linux、Windowsで動作します。

📦 インストール

npxを使用する（推奨）

インストール不要！直接実行します：

npx simple-commands-mcp @config.json

グローバルインストール

npm install -g simple-commands-mcp
simple-commands-mcp @config.json

ローカル開発用インストール

git clone https://github.com/yourusername/simple-commands-mcp.git
cd simple-commands-mcp
npm install
npm run build
npm link
simple-commands-mcp @config.json

💻 使用例

基本的な使用法

ツール定義を含む config.json ファイルを作成します：

{
  "tools": [
    {
      "name": "list_files",
      "description": "List files in current directory",
      "command": "ls -la",
      "daemon": false
    },
    {
      "name": "dev_server",
      "description": "Start development server",
      "command": "npm run dev",
      "daemon": true
    }
  ]
}

次に、MCPサーバーを実行します：

npx simple-commands-mcp @config.json

設定オプション

設定内の各ツールには、以下のプロパティがあります：

• name (文字列、必須)：ツールの一意の識別子
• description (文字列、必須)：ツールの機能を人間が読める形式で説明したもの
• command (文字列、必須)：実行するシェルコマンド
• daemon (ブール値、必須)：長時間実行プロセスの場合は true、単発コマンドの場合は false

デーモンツール

ツールの daemon を true に設定すると、サーバーは自動的に4つのコマンドを作成します：

• {name}_start：デーモンプロセスを開始します。
• {name}_status：現在の状態、PID、稼働時間、最近の出力を取得します。
• {name}_stop：デーモンプロセスを停止します。
• {name}_logs：最後のN行の出力を取得します（デフォルト: 50）。

例：daemon: true を設定した dev_server ツールは、以下のコマンドを作成します：

• dev_server_start
• dev_server_status
• dev_server_stop
• dev_server_logs

高度な使用法

シンプルコマンド設定

{
  "tools": [
    {
      "name": "git_status",
      "description": "Show git repository status",
      "command": "git status",
      "daemon": false
    },
    {
      "name": "run_tests",
      "description": "Run test suite",
      "command": "npm test",
      "daemon": false
    },
    {
      "name": "build_project",
      "description": "Build the project",
      "command": "npm run build",
      "daemon": false
    }
  ]
}

開発環境設定

{
  "tools": [
    {
      "name": "frontend",
      "description": "Frontend development server with hot reload",
      "command": "npm run dev:frontend",
      "daemon": true
    },
    {
      "name": "backend",
      "description": "Backend API server",
      "command": "npm run dev:backend",
      "daemon": true
    },
    {
      "name": "database",
      "description": "Local database server",
      "command": "docker-compose up db",
      "daemon": true
    },
    {
      "name": "migrate",
      "description": "Run database migrations",
      "command": "npm run db:migrate",
      "daemon": false
    }
  ]
}

MCPクライアント設定

このサーバーをMCPクライアント（Claude Desktopなど）で使用するには、MCP設定に追加します：

{
  "mcpServers": {
    "simple-commands": {
      "command": "npx",
      "args": ["simple-commands-mcp", "@/path/to/your/config.json"]
    }
  }
}

📚 ドキュメント

作業ディレクトリ

コマンドは、MCPサーバーを実行するディレクトリで実行されます。特定のディレクトリでコマンドを実行するには：

1. そのディレクトリからサーバーを起動します：

   cd /path/to/project
   npx simple-commands-mcp @config.json
   

2. または、コマンド内で絶対パスを使用します：

   {
     "name": "project_build",
     "description": "Build the project",
     "command": "cd /path/to/project && npm run build",
     "daemon": false
   }
   

トラブルシューティング

サーバーが起動しない場合

• Node.js 18以上がインストールされていることを確認します：node --version
• 設定ファイルが有効なJSONであることを確認します。
• 設定ファイルのパスが正しく、@ で始まっていることを確認します。

コマンドが実行されない場合

• 同じディレクトリから手動でコマンドを実行したときに動作することを確認します。
• 必要な依存関係がPATHに含まれていることを確認します。
• サーバーログを確認してエラーメッセージを確認します。

デーモンプロセスが停止しない場合

• サーバーは以下の場合に自動的にすべてのデーモンプロセスを追跡して終了します：
  • MCPクライアントが切断されたとき
  • サーバーがSIGINT/SIGTERMを受信したとき
  • {name}_stop コマンドを使用したとき
• Ctrl+Cを使用してサーバーとすべてのデーモンを正常にシャットダウンします。

開発

ソースからビルド

npm install
npm run build

開発モードで実行

npm run dev

プロジェクト構造

simple-commands-mcp/
├── src/
│   ├── cli.ts           # CLI entry point for npx
│   ├── server.ts        # Main MCP server
│   ├── types.ts         # TypeScript type definitions
│   ├── logger.ts        # Logging utilities
│   ├── processManager.ts # Daemon process management
│   └── toolExecutor.ts  # Command execution logic
├── dist/                # Compiled JavaScript (generated)
├── config.json          # Example configuration
├── package.json         # Package metadata and scripts
└── tsconfig.json        # TypeScript configuration

📄 ライセンス

MIT

貢献

貢献は大歓迎です！プルリクエストを送信してください。

サポート

問題や機能要求については、GitHub Issues ページを使用してください。