使用说明
MCP终端服务器-Windows安装程序
什么是MCP?
MCP(模型上下文协议)允许外部工具和AI客户端(此处为Claude AI)之间的通信。此项目设置了一个与MCP兼容的终端服务器,以在定义的工作区内执行shell命令。
安装桌面版Claude
- 下载并安装 Claude桌面版 克劳德的官方网站。
- 窗户: 按照安装程序的步骤进行操作。
- 打开应用程序并登录。
步骤1:安装 uv
方法1:独立安装程序
在中运行此命令 PowerShell:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
方法2:PyPI
如果你安装了Python:
pip install uv # or
pipx install uv
安装后,重新启动终端 所以 uv 被认可。
步骤2:创建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:专用工作区目录。
步骤3:创建一个Python项目
cd D:\path\to\mcp\servers\terminal_server
uv init
这将初始化内部的Python项目 terminal_server.
步骤4:设置虚拟环境
uv venv
.venv\Scripts\activate
这将创建并激活一个虚拟环境,保持依赖关系的隔离。
步骤5:安装所需的软件包
uv add "mcp[cli]"
这将安装MCP包以启用与Claude的通信。
步骤6:运行MCP终端服务器
uv run terminal_server.py
这将启动虚拟环境中的终端服务器。
步骤7:为桌面配置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 for Desktop
重新启动后,您应该看到 锤图标,意味着您的工具已准备好使用! 🚀