Terminal MCP Server

Terminal MCP 服务

一种模型上下文协议（MCP）服务，可通过 Claude Desktop 执行终端命令。

功能

• 使用参数和选项执行任意终端命令
• 在切换目录时保持状态
• 获取终端环境信息
• 完整捕获输出（标准输出、标准错误、退出代码）
• 妥善处理和格式化错误

前提条件

• Node.js v18 或更高版本
• TypeScript
• Claude Desktop

安装

1. 克隆代码仓库：

git clone https://github.com/stat-guy/terminal.git
cd terminal

2. 安装依赖：

npm install

3. 构建项目：

npm run build

本地开发设置

1. 创建或编辑 Claude Desktop 配置文件：

   • 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
   • 在 Windows 上：%APPDATA%\\Claude\\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "terminal": {
      "command": "node",
      "args": [
        "[PATH_TO_REPO]/dist/index.js"
      ],
      "env": {
        "PERMISSION_REQUIRED": "true"
      }
    }
  }
}

将 [PATH_TO_REPO] 替换为克隆的代码仓库的实际路径。

2. 重启 Claude Desktop

可用工具

execute_command

• 执行任意终端命令
• 支持命令参数和选项
• 捕获完整输出和退出代码

change_directory

• 更改当前工作目录
• 在命令之间保持状态
• 支持相对路径和绝对路径

get_current_directory

• 获取当前工作目录路径

get_terminal_info

• 获取终端环境信息
• 显示 shell、用户、平台和近期命令历史

使用示例

请 Claude 执行如下终端命令：

Can you check what's in my current directory?
-> Executes: ls -la

Can you tell me the current directory?
-> Executes: pwd

Can you change to the Downloads folder?
-> Executes: cd ~/Downloads

安全注意事项

• 执行命令需要通过 Claude Desktop 获得用户的明确许可
• 可通过配置控制环境变量
• 命令执行包含超时和错误处理

开发

1. 监听更改：

npm run watch

2. 测试更改：

• 修改 src/ 中的源文件
• 使用 npm run build 重新构建
• 重启 Claude Desktop 以加载更改

项目结构

/
├── src/
│   └── index.ts    # Main server implementation
├── package.json    # Project configuration and dependencies
├── tsconfig.json  # TypeScript configuration
└── README.md      # This file

贡献

欢迎贡献！欢迎提交 Pull Request。

许可证

MIT 许可证