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.txtMACOS
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用户的步骤
- 请转到Claude Desktop左上角的菜单按钮。
- 然后选择 文件 >点击 设置.
- 在设置窗口中，单击 开发者 在左边。
- 在结果窗口的底部/中间有一个 编辑配置 按钮-单击该按钮。
- 这将打开此文件所在的文件夹。此文件夹应为
C:\Users\\AppData\Roaming\Claude.
*如果按照这些步骤操作时文件不存在，Claude应该自动创建该文件！*
- 现在寻找
claude_desktop_config.json在这里。以防它不存在，请创建一个新文件。 - 将下面给出的配置复制到文件中。请注意，windows具有不同的路径命名约定，因此存在差异！
- 完成后，单击左上角的菜单重新启动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运行 任何 在工作区内的计算机上执行命令。这很强大，但很危险。
- 从不 在公共网络上运行此服务器。
- 总是 在让人工智能运行之前，监控它建议的命令。
- 在实际应用中，您应该限制允许服务器运行的命令。
______________________________________________________________________