mcpterm

mcpterm

site icon
2025.02.03 3
Go终端会话管理TUI 兼容开发效率
mcpterm 是一个 MCP 工具服务器,提供有状态的、兼容 TUI 的终端会话。它是一个使用 mcp-go 的概念验证项目,与 Claude Desktop 配合使用效果良好。
View on GitHub

Overview

基本能力

产品定位

mcpterm 是一个终端会话管理工具,旨在提供有状态的、兼容 TUI 的终端会话,特别适合与 Claude Desktop 配合使用。

核心功能

  1. 提供有状态的终端会话,支持命令的连续执行。
  2. 兼容 TUI 应用,如 vim 或 Python REPL。
  3. 支持控制序列的输入,便于与终端应用交互。

适用场景

  1. 在 Claude Desktop 中运行和管理终端会话。
  2. 与 TUI 应用(如 vim、Python REPL)交互。
  3. 在终端中执行连续的命令序列。

工具列表

  1. run: 在有状态的终端会话中运行命令。例如,如果进入一个目录,后续命令将在该目录中运行。
  2. runScreen: 运行命令或一系列按键操作,并返回屏幕输出。适用于 TUI 应用,如 vim 或 Python REPL。

常见问题解答

  1. 如何与 TUI 应用交互?
  2. 使用 runScreen 工具,并配合控制序列(如 Ctrl+X、Ctrl+O 等)进行交互。
  3. 如何与 Claude Desktop 集成?
  4. 编辑 claude_desktop_config.json 文件,添加 mcpterm 配置,并重启 Claude Desktop。

使用教程

使用依赖

  1. 确保已安装 Git 和 Make 工具。

安装教程

  1. 克隆仓库并编译: bash git clone https://github.com/dwrtz/mcpterm.git cd mcpterm make
  2. mcpterm 二进制文件移动到 PATH 目录: bash sudo mv bin/mcpterm /usr/local/bin/mcpterm

调试方式

  1. 添加到 Claude Desktop 配置:
  2. 编辑 claude_desktop_config.json 文件(在 Mac 上位于 ~/Library/Application Support/Claude/claude_desktop_config.json): json { "mcpServers": { "mcpterm": { "command": "mcpterm", "args": [] } } }
  3. 重启 Claude Desktop。
  4. 测试工具:
  5. 使用 run 工具运行命令,确保会话状态保持。
  6. 使用 runScreen 工具与 TUI 应用交互,确保屏幕输出正确。

许可证

None