MCP 终端服务器

一个安全的命令行界面服务器，用于模型上下文协议 (MCP)，使 AI 模型能够与您的终端交互，同时保持安全和控制。

功能

• 🔒 通过可配置的权限安全执行命令
• 📁 在允许的路径内进行文件系统操作
• 🌍 环境变量管理
• 💻 跨平台支持（Windows、macOS、Linux）
• 🔌 通过命令执行支持远程系统连接

与 Claude Desktop 一起使用

将服务器配置添加到您的 Claude Desktop 配置文件：

{
  "mcpServers": {
    "terminal": {
      "command": "npx",
      "args": [
        "@dillip285/mcp-terminal",
        "--allowed-paths",
        "/path/to/allowed/directory"
      ]
    }
  }
}

重新启动 Claude Desktop 以应用更改。您现在可以通过 Claude 使用终端功能，并具有安全的文件访问和命令执行权限。

可用工具

• execute_command: 安全地运行终端命令（包括 SSH 和远程命令）

安全性

• 所有操作都限制在指定的允许路径内
• 命令在执行前经过验证和清理
• 环境变量得到仔细管理
• 针对安全相关问题进行适当的错误处理

开发

# 克隆仓库
git clone https://github.com/dillip285/mcp-terminal.git

# 安装依赖
npm install

# 配置 npm 身份验证
cp .npmrc.example .npmrc
# 编辑 .npmrc 并添加您的 NPM_TOKEN

# 运行测试
npm test

# 构建项目
npm run build

发布

要发布软件包：

1. 将 .npmrc.example 复制到 .npmrc
2. 将您的 npm 身份验证令牌添加到 .npmrc
3. 运行 npm publish --access public

注意：永远不要提交包含身份验证令牌的 .npmrc 文件。它已经添加到 .gitignore 中。

贡献

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'feat: Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。

相关项目

• 模型上下文协议
• Claude Desktop

支持

对于错误报告和功能请求，请打开一个 issue。