MCP Terminal Server

🚀 MCP 终端服务器

MCP 终端服务器是一款安全的命令行接口服务器，专为模型上下文协议（MCP）设计。它能让 AI 模型与您的终端进行交互，同时确保操作的安全性和可控性。

🚀 快速开始

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

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

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

✨ 主要特性

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

💻 使用示例

基础用法

将服务器配置添加到Claude Desktop配置文件后，即可通过Claude使用终端功能。示例配置如下：

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

高级用法

使用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. 叉克隆仓库
2. 创建功能分支（例如 git checkout -b feature/amazing-feature）
3. 提交更改（例如 git commit -m 'feat: 添加神奇功能'）
4. 推送到分支（例如 git push origin feature/amazing-feature）
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证，详情请查看 LICENSE 文件。

🔗 相关项目

• 模型上下文协议
• Claude Desktop

🛠️ 支持

若要进行 bug 报告或提出功能需求，请打开 Issues。