mcpterm

mcpterm

ステートフルで TUI に対応したターミナルセッションを提供する MCP ツールサーバーです。

mcp-go を使用した概念実証です。

Claude Desktop と非常によく連携します。

使用方法

リポジトリをクローンし、make を実行して bin/mcpterm を生成します。

git clone https://github.com/dwrtz/mcpterm.git
cd mcpterm
make

mcpterm バイナリを PATH 内のディレクトリに移動します。

sudo mv bin/mcpterm /usr/local/bin/mcpterm

Claude Desktop に追加する

claude_desktop_config.json を編集します（Mac では ~/Library/Application Support/Claude/claude_desktop_config.json にあります）。

{
  "mcpServers": {
    "mcpterm": {
      "command": "mcpterm",
      "args": []
    }
  }
}

Claude Desktop を再起動します。これで Claude に mcpterm が提供する 2 つのツールが表示されます。

ツール

run：ステートフルなターミナルセッションでコマンドを実行します。たとえば、あるディレクトリに移動すると、以降のコマンドはそのディレクトリで実行されます。

runScreen：コマンドまたは一連のキー入力を実行し、画面出力を返します。vim や Python REPL などの TUI アプリ向けです。

ヒント：

runScreen ツールで次の制御シーケンスを使うよう Claude に指示するとよいでしょう。

"^X": "\x18", // Ctrl+X
"^O": "\x0F", // Ctrl+O
"^J": "\x0A", // Enter
"^C": "\x03", // Ctrl+C
"^D": "\x04", // Ctrl+D
"^Z": "\x1A", // Ctrl+Z
"^[": "\x1B", // Escape
"^H": "\x08", // Backspace
"^M": "\x0D", // Carriage return
"^L": "\x0C", // Form feed
"^G": "\x07", // Bell
"^U": "\x15", // Clear line
"^W": "\x17", // Delete word
"^Y": "\x19", // Paste from kill buffer
"^V": "\x16", // Literal input
"^K": "\x0B", // Kill line
"^E": "\x05", // End of line
"^A": "\x01", // Beginning of line
"^I": "\x09", // Tab

完璧ではありませんが、かなりうまく動作します。Claude は vim を使って Dockerfile を作成し、インタラクティブセッションでコンテナを起動してから、コンテナ内で Python REPL などのコマンドを実行できます。