mcp-server-commands

Commands MCP Server

任意のコマンドを実行できる Model Context Protocol（MCP）サーバーです。

要件

• Node.js 18 以降
• VS Code、Cursor、Windsurf、Claude Desktop、またはその他の MCP クライアント

はじめに

ローカル（Stdio）

まず、使用するクライアントに Commands MCP サーバーをインストールします。一般的な設定は次のとおりです。

{
  "mcpServers": {
    "commands": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest",
        "--cwd",
        "/tmp"
      ]
    }
  }
}

# For VS Code
code --add-mcp '{"name":"commands","command":"npx","args":["@agent-infra/mcp-server-commands@latest"]}'

{
  "mcpServers": {
    "commands": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "commands": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "commands": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest"
      ]
    }
  }
}

リモート（SSE / Streamable HTTP）

同時に、--port $your_port 引数を使用してブラウザ MCP を起動すると、SSE および Streamable HTTP サーバーに変換できます。

# normal run remote mcp server
npx @agent-infra/mcp-server-commands --port 8089

次のいずれかの MCP サーバーリモートエンドポイントを使用できます。

• Streamable HTTP（推奨）：http://127.0.0.1:8089/mcp
• SSE：http://127.0.0.1:8089/sse

続いて、MCP クライアントの設定で、url に SSE エンドポイントを設定します。

{
  "mcpServers": {
    "commands": {
      "url": "http://127.0.0.1:8089/sse"
    }
  }
}

Streamable HTTP の場合は、url に次の値を設定します。

{
  "mcpServers": {
    "commands": {
      "type": "streamable-http", // If there is MCP Client support
      "url": "http://127.0.0.1:8089/mcp"
    }
  }
}

インメモリ呼び出し

MCP クライアントが JavaScript / TypeScript ベースで開発されている場合、ユーザーが Commands MCP を使用するためにコマンドラインインターフェースをインストールする必要がないよう、プロセス内呼び出しを直接利用できます。

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';

// type: module project usage
import { createServer } from '@agent-infra/mcp-server-commands';
// commonjs project usage
// const { createServer } = await import('@agent-infra/mcp-server-commands')

const client = new Client(
  {
    name: 'test commands client',
    version: '1.0',
  },
  {
    capabilities: {},
  },
);

const server = createServer();
const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();

await Promise.all([
  client.connect(clientTransport),
  server.connect(serverTransport),
]);

// list tools
const result = await client.listTools();
console.log(result);

// call tool
const toolResult = await client.callTool({
  name: 'run_script',
  arguments: {
    interpreter: 'node',
    script: 'console.log(1+1);',
  },
});
console.log(toolResult);

開発

http://127.0.0.1:6274/ にアクセスします。

npm run dev