Terminal MCP Server

🚀 終端 MCP 服務器

本倉庫實現了終端命令的模型上下文協議（MCP）服務器。藉助該服務器，Claude 能夠在指定目錄中執行終端命令，為用戶提供更便捷的操作體驗。

🚀 快速開始

✨ 主要特性

• 實現終端命令的模型上下文協議（MCP），支持Claude在指定目錄執行終端命令。
• 配置靈活，可根據需求指定Claude可訪問的目錄。

📦 安裝指南

先決條件

• Node.js (v16 或更高版本)
• npm (v7 或更高版本)

本地安裝

1. 克隆倉庫：

git clone https://github.com/algae514/terminal-mcp-server.git
cd terminal-mcp-server

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 使啟動腳本具有可執行性：

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 服務器在指定目錄中執行終端命令。

🔧 技術細節

本服務器基於Node.js和npm構建，通過配置Claude的配置文件，使其能夠與Claude進行交互，實現終端命令的執行。

⚠️ 安全注意事項

• 要允許終端在某個目錄中運行命令，您需要在 maven-tool.json 文件中提供這些位置。示例 URL 已經提供。
• 對於暴露給 Claude 的目錄要格外小心，因為它將能夠在此類位置中執行命令。
• 考慮使用具有受限權限的專用用戶來運行服務器。
• 檢查 Claude 執行的命令以確保它們安全且適當。

📄 許可證

本項目採用 MIT License。