终端服务器设置工具

MCP终端服务器设置工具用于在定义的工作空间中执行shell命令,实现外部工具与AI客户端(如Claude-AI)之间的通信。

  • by kunjanshah0811
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kunjanshah0811/mcp-terminal-server

使用说明

MCP终端服务器-Windows安装程序

什么是MCP?

MCP(模型上下文协议)允许外部工具和AI客户端(此处为Claude AI)之间的通信。此项目设置了一个与MCP兼容的终端服务器,以在定义的工作区内执行shell命令。


安装桌面版Claude

  1. 下载并安装 Claude桌面版 克劳德的官方网站。
  2. 窗户: 按照安装程序的步骤进行操作。
  3. 打开应用程序并登录。

步骤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

重新启动后,您应该看到 锤图标,意味着您的工具已准备好使用! 🚀