AI导哈

终端访问工具

MCP终端工作区提供了一套工具和服务器，使AI代理能够通过终端访问与计算机系统交互。

  • by AnmolRajpoot25
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AnmolRajpoot25/MCP_server_architecture

使用说明

MCP终端工作区

此工作区包含一组模型上下文协议（MCP）服务器和工具，旨在为AI代理提供系统级功能，特别是终端访问。本项目演示了如何使用高级 MCPServer 实施。

🏗 项目结构

此存储库遵循用于组织MCP服务器的分层结构。

  • servers/：包含单个MCP服务器实现。
    • terminal_server/：提供执行shell命令的工具的服务器。
  • requirements.txt：项目的全局依赖关系。
  • ATTRIBUTION.md：开源信用和商标免责声明。
  • LICENSE：项目许可信息。

🛠 架构拓扑

工作空间被设计为可扩展的。每个目录下 servers/ 表示一个独立的MCP服务器，可以与Claude Desktop或基于Google ADK的代理等客户端集成。

Root
├── servers/
│   └── terminal_server/ (Logic for shell execution)
├── requirements.txt

🖥 终端MCP服务器

终端MCP服务器允许人工智能（如克劳德）使用高级命令与您的计算机终端进行交互 MCPServer 实施。

🛠 工具

execute_command

在配置的工作区中执行shell命令，并返回其输出或错误消息。该工具是人工智能与主机系统交互的主要方式。

  • 参数:
    • command （string）：要执行的完整shell命令。

🚀 入门指南

1.安装依赖项

切换到使用PowerShell（Windows）或终端（MacOS）克隆的代码所在的目录，然后运行安装命令。

注意：这将安装MCP版本2（在requirements.txt中指定），允许Claude运行服务器。

窗户

cd C:\<PROJECT_PATH>\mcp-v2-server-examples\01_terminal_server
pip install -r requirements.txt

MACOS

cd /Users/<PROJECT_PATH>/mcp-v2-server-examples/01_terminal_server
pip3 install -r requirements.txt

（或使用 pip 如果 pip3 未找到）

⚠️ 2.配置工作区（非常重要）

该工具需要一个特定的文件夹来保存文件。如果没有此设置，该工具将失败。从以下两种方法中选择一种。

方法A：创建默认文件夹（最简单）

只需创建一个名为的文件夹 workspace 内部A mcp 用户目录中的文件夹。如果没有设置环境变量，代码将自动在此处查看。

MacOS/Linux： ~/mcp/workspace

窗户： C:\Users\<YOUR_USERNAME>\mcp\workspace

方法B：设置自定义路径（.env）

如果要使用特定的现有文件夹，请打开 .env 在项目中创建文件，并在下面添加变量。

MacOS/Linux示例： TERMINAL_WORKSPACE=/Users/jdoe/projects/my_mcp_workspace

Windows示例： TERMINAL_WORKSPACE=C:\\Users\\jdoe\\projects\\my_mcp_workspace

重要提示： 在Windows上，必须使用双反斜杠(\\)在 .env 文件。

💻 Windows用户的步骤

  1. 请转到Claude Desktop左上角的菜单按钮。
  2. 然后选择 文件 >点击 设置.
  3. 在设置窗口中，单击 开发者 在左边。
  4. 在结果窗口的底部/中间有一个 编辑配置 按钮-单击该按钮。
  5. 这将打开此文件所在的文件夹。此文件夹应为 C:\Users\<YourUserName>\AppData\Roaming\Claude. 如果按照这些步骤操作时文件不存在，Claude应该自动创建该文件！
  6. 现在寻找 claude_desktop_config.json 在这里。以防它不存在，请创建一个新文件。
  7. 将下面给出的配置复制到文件中。请注意，windows具有不同的路径命名约定，因此存在差异！
  8. 完成后，单击左上角的菜单重新启动Claude Desktop，然后 文件 然后 退出。不要从任务栏关闭，因为这并不能正确退出Claude桌面。然后重新启动它，您应该在聊天框图标中看到聊天框左下角附近的控件的终端工具。

claude_desktop_config.json Windows内容

{
  "mcpServers": {
    "terminal": {
      "command": "python",
      "args": ["C:\\<PROJECT_PATH>\\mcp-v2-server-examples\\01_terminal_server\\servers\\terminal_server\\main.py"]
    }
  }
}

⚠️ 安全警告

此服务器允许AI运行 任何 在工作区内的计算机上执行命令。这很强大，但很危险。

  • 从不 在公共网络上运行此服务器。
  • 总是 在让人工智能运行之前，监控它建议的命令。
  • 在实际应用中，您应该限制允许服务器运行的命令。

相关 MCP