Mcpterm

🚀 mcpterm 紹介

mcptermは、MCPツールサーバーで、状態化されたTUI互換のターミナルセッションを提供します。

これは 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アプリケーションに使用されます。

高度な使用法

使用技巧

Claudeに以下の制御シーケンスを使用して runScreen ツールと連携するよう指示することができます。

"^X": "\x18", // Ctrl+X
"^O": "\x0F", // Ctrl+O
"^J": "\x0A", // 回车键
"^C": "\x03", // Ctrl+C
"^D": "\x04", // Ctrl+D
"^Z": "\x1A", // Ctrl+Z
"^[": "\x1B", // 逃逸键
"^H": "\x08", // 删除键
"^M": "\x0D", // 回车
"^L": "\x0C", // 换页符
"^G": "\x07", // 铃声
"^U": "\x15", // 清空行
"^W": "\x17", // 删除单词
"^Y": "\x19", // 从剪贴板粘贴
"^V": "\x16", // 字面输入
"^K": "\x0B", // 删除行
"^E": "\x05", // 行末
"^A": "\x01", // 行首
"^I": "\x09"  // 制表符

これはまだ完全ではありませんが、非常に実用的です。Claudeはvimを使ってDockerfileを作成し、コンテナを起動してインタラクティブセッションに入り、そのコンテナ内でPython REPLセッションを起動するなどの操作が可能です。