终端命令协议服务器

一个实现终端命令模型上下文协议(MCP)的服务器,用于在指定目录中执行终端命令。

  • by algae514
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 algae514/terminal-mcp-server

使用说明

终端MCP服务器

此存储库包含用于终端命令的模型上下文协议(MCP)服务器实现。

安装说明

先决条件

  • Node.js(v16或更高版本)
  • 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

配置

要将此服务器与Claude一起使用,您需要更新Claude配置以包含终端MCP服务器。

更新您的Claude配置文件(通常位于 ~/.config/claude/claude_desktop_config.json 或类似)包括以下内容:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/directory1",
        "/path/to/directory2",
        "/path/to/directory3"
      ]
    },
    "terminal": {
      "command": "/path/to/terminal-mcp-server/start-server.sh",
      "args": []
    }
  }
}

替换 /path/to/directory1, /path/to/directory2,等等。使用您要让Claude访问的目录。

替换 /path/to/terminal-mcp-server 使用克隆此存储库的实际路径。

用法

配置后,Claude可以通过终端MCP服务器在指定目录中执行终端命令。

安全考虑

  • 要允许终端在目录中运行命令,您需要在maven-tool.json文件中提供它的位置。提供了一个示例url。
  • 请小心您向Claude公开的目录,因为它可以在这些位置执行命令。
  • 考虑使用权限有限的专用用户来运行服务器。
  • 检查Claude执行的命令,以确保它们是安全和适当的。

许可证

MIT许可证