MCP Terminal Server

🚀 MCP 終端服務器 - Windows 安裝指南

MCP 終端服務器項目設置了一個兼容 MCP 的終端服務器，用於在定義的工作區中執行 shell 命令。MCP（模型上下文協議）允許外部工具與 AI-Client（此處為 Claude-AI）之間進行通信。

🚀 快速開始

✨ 主要特性

• MCP（模型上下文協議）實現外部工具與 Claude-AI 的通信。
• 終端服務器可在定義的工作區執行 shell 命令。

📦 安裝指南

安裝Claude桌面版

1. 從Claude的官方網站下載並安裝Claude 桌面版。
2. Windows：按照安裝程序步驟進行操作。
3. 打開應用程序並登錄。

第一步：安裝 uv

方法 1：獨立安裝程序

在 PowerShell 中運行以下命令：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

方法 2：PyPI

若已安裝 Python，可運行以下命令：

pip install uv  # 或者
pipx install uv

安裝完成後，重啟終端以使 uv 被識別。

第二步：創建MCP目錄結構

在 PowerShell 中運行以下命令：

mkdir D:\path\to\mcp\servers\terminal_server
mkdir $env:USERPROFILE\mcp\workspace

• D:\path\to\mcp\servers\terminal_server：存儲所有 MCP 服務器。
• $env:USERPROFILE\mcp\workspace：專用工作區目錄。

第三步：創建Python項目

cd D:\path\to\mcp\servers\terminal_server
uv init

此命令在 terminal_server 目錄中初始化一個 Python 項目。

第四步：設置虛擬環境

uv venv
.venv\Scripts\activate

此命令創建並激活一個虛擬環境，以保持依賴項的隔離。

第五步：安裝所需包

uv add "mcp[cli]"

此命令安裝 MCP 包，以啟用與Claude 的通信。

第六步：運行MCP終端服務器

uv run terminal_server.py

此命令啟動終端服務器（位於虛擬環境中）。

第七步：配置Claude桌面版

編輯 Claude 配置文件 位於：

C:\Users\<your-username>\AppData\Roaming\Claude\claude_desktop_config.json

添加以下配置：

{
    "mcpServers": {
        "terminal": {
            "command": "C:\\path\\to\\uv.exe",
            "args": [
                "--directory", "D:\\path\\to\\mcp\\servers\\terminal_server",
                "run",
                "terminal_server.py"
            ]
        }
    }
}

最後一步：重啟Claude桌面版

重啟後，你應該看到一個 錘子圖標，表示你的工具已準備就緒！🚀