mcpField
T
Terminal MCP Server

Terminal MCP Server

本地服务
github.com/algae514开发工具183 周前更新

关于 Terminal MCP Server

Terminal MCP Server 是一个 MCP 服务实现,可让 Claude 在配置的目录中执行终端命令。项目说明强调目录访问控制,以及授予命令执行权限时的谨慎。

主要功能

  1. 01通过 Claude 执行终端命令
  2. 02限制访问已配置的目录
  3. 03配置为 Claude MCP 服务

适用场景

  1. 01通过 Claude 运行终端命令
  2. 02将命令访问限制在指定目录

MCP 相关

向 Claude 等 MCP 客户端提供终端命令执行能力,访问范围受配置目录限制。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

终端 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 将能够在这些位置执行命令。
  • 考虑使用权限受限的专用用户来运行此服务。
  • 检查 Claude 执行的命令,确保其安全且适当。

许可证

MIT 许可证

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。