终端命令执行服务

壳牌MCP服务器

简单模型上下文协议（MCP）服务器，公开单个 terminal 用于运行shell命令的工具。

先决条件

• Python 3.11+
• 紫外线 或 pip

安装

uv sync
# or
pip install -e .

用法

通过stdio运行服务器：

python main.py

服务器注册了一个 terminal 工具。使用形状如下的对象调用它：

{
  "command": "echo hello"
}

命令输出作为MCP返回 TextContent。错误以前缀出现 Error: 消息。

资源

此服务器公开了一个资源：

• 身份证件： mcpreadme://desktop
• 返回以下内容 mcpreadme.md 已从OneDrive桌面解析。

解决顺序：

• $OneDrive/Desktop/mcpreadme.md
• ~/OneDrive/Desktop/mcpreadme.md
• ~/Desktop/mcpreadme.md

如果文件丢失或不可读，则返回文本错误消息。

码头工人

在容器内构建并运行uv（根据uv Docker指南）：

docker build -t shellserver .
docker run --rm -it shellserver

此映像安装 uv 来自官方形象和用途：

• 依赖缓存层通过 uv sync --no-install-project
• 最终运行命令相当于local： uv run main.py

参考：uv Docker集成文档： 安装项目