MCP Terminal Server - Windows Setup

产品定位

MCP-Terminal-Server 是一个基于 MCP（Model Context Protocol）的终端服务器，用于在定义的工作空间中执行 shell 命令，实现外部工具与 AI 客户端（如 Claude-AI）之间的通信。

核心功能

1. 通过 MCP 协议实现外部工具与 AI 客户端的通信。
2. 在定义的工作空间中执行 shell 命令。
3. 支持 Python 项目的初始化和管理。
4. 提供虚拟环境隔离依赖。
5. 与 Claude for Desktop 集成，提供工具支持。

适用场景

1. 开发者需要与 AI 客户端进行交互的场景。
2. 需要在特定工作空间中执行 shell 命令的场景。
3. 需要隔离 Python 依赖的项目开发。

使用教程

使用依赖

1. 安装 Claude for Desktop：
2. 从 Claude 官方网站下载并安装。
3. Windows 用户按照安装步骤完成安装。

4. 打开应用并登录。

5. 安装 uv：

6. 方法 1：独立安装器 powershell powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
7. 方法 2：通过 PyPI 安装 powershell pip install uv # 或 pipx install uv
8. 安装完成后重启终端。

安装教程

1. 创建 MCP 目录结构： powershell mkdir D:\path\to\mcp\servers\terminal_server mkdir $env:USERPROFILE\mcp\workspace

2. 设置 Python 项目： powershell cd D:\path\to\mcp\servers\terminal_server uv init

3. 设置虚拟环境： powershell uv venv .venv\Scripts\activate

4. 安装所需包： powershell uv add "mcp[cli]"

5. 运行 MCP 终端服务器： powershell uv run terminal_server.py

6. 配置 Claude for Desktop：

7. 编辑配置文件 C:\Users\<your-username>\AppData\Roaming\Claude\claude_desktop_config.json，添加以下内容： json { "mcpServers": { "terminal": { "command": "C:\\path\\to\\uv.exe", "args": [ "--directory", "D:\\path\\to\\mcp\\servers\\terminal_server", "run", "terminal_server.py" ] } } }
8. 重启 Claude for Desktop。

调试方式

1. 确保 uv 已正确安装并可用。
2. 确保 MCP 目录结构已正确创建。
3. 确保 Python 项目和虚拟环境已正确设置。
4. 确保 mcp[cli] 包已正确安装。
5. 确保 Claude for Desktop 的配置文件已正确修改并重启。
6. 检查终端服务器是否正常运行。

许可证

None