Mcpterm

🚀 mcpterm 介紹

mcpterm 是一個 MCP 工具服務器，它能夠提供狀態化的、與 TUI 兼容的終端會話。此項目是使用 mcp - go 的概念驗證項目，並且與 Claude Desktop 配合使用能達到不錯的效果。

🚀 快速開始

安裝步驟

1. 克隆倉庫並運行 make 生成 bin/mcpterm：

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

2. 將 mcpterm 二進制文件移動到 PATH 目錄中的某個位置：

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

添加到 Claude Desktop

1. 編輯你的 claude_desktop_config.json 文件（在 Mac 上該文件位於 ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

2. 重啟 Claude Desktop。此時，Claude 應該能夠看到 mcpterm 提供的兩個工具。

✨ 主要特性

工具說明

• run：可在狀態化終端會話中運行命令。例如，當你切換到某個目錄後，後續命令將在該目錄下執行。
• runScreen：運行命令或一系列按鍵操作，並返回屏幕輸出。該工具主要用於 TUI 應用程序，如 vim 或 Python REPL。

💻 使用示例

基礎用法

你可能希望告訴 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 會話。