🚀 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桌面版

重启后，你应该看到一个 锤子图标，表示你的工具已准备就绪！🚀