🚀 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 会话。