🚀 MCP 终端服务器 - Windows 安装指南
MCP 终端服务器允许在 Windows 系统上搭建一个兼容 MCP 的终端服务器，实现外部工具与 AI - Client（Claude - AI）的通信，可在定义的工作区中执行 shell 命令。
🚀 快速开始
安装Claude桌面版
- 从 Claude 的官方网站下载并安装 Claude 桌面版。
- Windows：按照安装程序步骤进行操作。
- 打开应用程序并登录。
服务器安装步骤
第一步：安装 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\\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 命令和工作区设置，实现更复杂的任务。