cmd-line-executor MCP server

cmd-line-executor MCP サーバー

コマンドラインアプリを呼び出す MCP サーバーの例です

コンポーネント

ツール

サーバーは次のツールを実装しています：

• run_command：コマンドラインのコメントを実行します
  • 文字列引数として「cmd」と「args」を受け取ります
  • コマンドを実行し、stdout、stderr、status_code などを返します

設定

クイックスタート

インストール

Claude Desktop

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

開発版／未公開サーバーの設定

``` "mcpServers": { "cmd-line-executor": { "command": "uv", "args": [ "--directory", "/Users/$(whoami)/experiments/claude-mvp/cmd-line-executor", "run", "cmd-line-executor" ] } } ```

公開済みサーバーの設定

``` "mcpServers": { "cmd-line-executor": { "command": "uvx", "args": [ "cmd-line-executor" ] } } ```

開発

ビルドと公開

パッケージを配布できるように準備するには：

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

uv sync

2. パッケージの配布物をビルドします：

uv build

これにより、dist/ ディレクトリにソース配布物と wheel 配布物が作成されます。

3. PyPI に公開します：

uv publish

注：環境変数またはコマンドフラグで PyPI の認証情報を設定する必要があります：

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名／パスワード：--username／UV_PUBLISH_USERNAME および --password／UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグが難しい場合があります。最適なデバッグ体験のために、MCP Inspector の使用を強くおすすめします。

次のコマンドを使い、npm 経由で MCP Inspector を起動できます：

npx @modelcontextprotocol/inspector uv --directory /Users/markus/experiments/claude-mvp/cmd-line-executor run cmd-line-executor

起動すると、Inspector にブラウザーからアクセスできる URL が表示され、デバッグを開始できます。