MCP-Terminal-Server

🚀 MCP 终端服务器 - Windows 安装指南

MCP 终端服务器允许在 Windows 系统上搭建一个兼容 MCP 的终端服务器，实现外部工具与 AI - Client（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桌面版

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

✨ 主要特性

MCP（模型上下文协议）允许外部工具与 AI - Client（此处为 Claude - AI）之间进行通信。该项目设置的兼容 MCP 的终端服务器，可在定义的工作区中执行 shell 命令。

📦 安装指南

上述的安装步骤详细说明了如何在 Windows 系统上安装 MCP 终端服务器，包括安装 Claude 桌面版、uv、创建目录结构、Python 项目、设置虚拟环境、安装所需包、运行服务器以及配置 Claude 桌面版等内容。

💻 使用示例

基础用法

在安装和配置完成后，可通过 Claude 桌面版与 MCP 终端服务器进行交互，在定义的工作区中执行 shell 命令。例如，在 Claude 中输入相应的命令，服务器将执行并返回结果。

高级用法

暂未提供相关高级用法示例，后续可根据实际需求进一步探索和补充。例如，可结合不同的 shell 命令和工作区设置，实现更复杂的任务。