Cmd Line Executor MCP

🚀 コマンドライン実行器 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%

🔧 開発

ビルドと公開

配布パッケージを準備するには、以下の手順を実行します。

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

uv sync

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

uv build

これにより、dist/ ディレクトリにソースコードとホイール配布が作成されます。

3. PyPI に公開します。

uv publish

⚠️ 重要な注意

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

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

デバッグ

MCP サーバーは標準入出力で動作するため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP Inspector の使用を強くおすすめします。

以下のコマンドを npm で実行することで、MCP インスペクターを起動できます。

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

起動後、インスペクターは URL を表示します。この URL をブラウザで開いてデバッグを開始できます。