Terminal MCP Server

Terminal MCP Server

site icon
2025.03.29 0
TypeScript终端命令自动化开发工具开发效率
Terminal MCP Server 是一个基于 Model Context Protocol (MCP) 的终端命令服务器实现,主要用于通过 Claude 配置来执行终端命令。它允许用户在指定的目录中执行命令,提供了终端操作的自动化能力。
View on GitHub

Overview

基本能力

产品定位

Terminal MCP Server 是一个终端命令的 MCP 服务器实现,旨在通过 Claude 配置实现终端命令的自动化执行。

核心功能

  1. 终端命令执行:通过 MCP 协议在指定目录中执行终端命令。
  2. 目录访问控制:允许配置多个目录,限制 Claude 的访问范围。
  3. 安全控制:提供安全建议,如使用有限权限的用户运行服务器。

适用场景

  1. 开发自动化:在开发过程中自动化执行重复的终端命令。
  2. 脚本管理:通过 Claude 管理并执行脚本。
  3. 目录操作:在指定目录中执行文件操作或其他终端命令。

工具列表

  1. start-server.sh:启动终端 MCP 服务器的脚本。
  2. npm:用于安装依赖和构建项目。
  3. Node.js:运行服务器的基础环境。

常见问题解答

  1. 如何配置目录访问?:在 maven-tool.json 文件中指定目录路径。
  2. 如何确保安全?:使用有限权限的用户运行服务器,并定期审查执行的命令。
  3. 如何更新配置?:修改 Claude 的配置文件以包含终端 MCP 服务器的路径。

使用教程

使用依赖

  1. 安装 Node.js (v16 或更高版本)
  2. 安装 npm (v7 或更高版本)

安装教程

  1. 克隆仓库:
git clone https://github.com/algae514/terminal-mcp-server.git
cd terminal-mcp-server
  1. 安装依赖:
npm install
  1. 构建项目:
npm run build
  1. 使启动脚本可执行:
chmod +x start-server.sh

调试方式

  1. 启动服务器:
./start-server.sh
  1. 检查日志:查看终端输出以确认服务器是否正常运行。
  2. 测试命令执行:通过 Claude 发送命令并验证执行结果。

许可证

该项目遵循 MIT 开源许可条款。