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。