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:\
\mcp-v2-server-examples\01_terminal_server
pip install -r requirements.txt

MACOS

cd /Users/
/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\\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\\AppData\Roaming\Claude.

*如果按照这些步骤操作时文件不存在，Claude应该自动创建该文件！*

1. 现在寻找 claude_desktop_config.json 在这里。以防它不存在，请创建一个新文件。
2. 将下面给出的配置复制到文件中。请注意，windows具有不同的路径命名约定，因此存在差异！
3. 完成后，单击左上角的菜单重新启动Claude Desktop，然后 文件 然后 退出。不要从任务栏关闭，因为这并不能正确退出Claude桌面。然后重新启动它，您应该在聊天框图标中看到聊天框左下角附近的控件的终端工具。

claude_desktop_config.json Windows内容

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

______________________________________________________________________

⚠️ 安全警告

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

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

______________________________________________________________________