使用说明
终端MCP服务器
一个简单的MCP（模型上下文协议）服务器，它公开了一个终端工具和一个用于运行shell命令和访问文档的资源。
特性
- 终端工具：执行shell命令并获取其输出
- 资源支持：访问MCP自述文件
- 工作目录支持：可选择为命令指定工作目录
- 超时保护：30秒后命令超时
- 错误处理：对失败的命令进行正确的错误处理
安装
该项目使用 uv 用于依赖性管理。安装依赖项：
uv sync
用法
运行服务器
python server.py
工具
服务器公开了一个名为 terminal 具有以下模式：
{
"name": "terminal",
"description": "Run terminal commands and return the output",
"inputSchema": {
"type": "object",
"properties": {
"command": {
"type": "string",
"description": "The shell command to execute"
},
"cwd": {
"type": "string",
"description": "Working directory for the command (optional)"
}
},
"required": ["command"]
}
}
示例用法
该工具可以通过以下方式调用：
{
"command": "ls -la",
"cwd": "/path/to/directory"
}
资源
服务器公开了一个用于访问MCP自述文档的资源：
- 统一资源标识符:
file:///resource/mcpreadme.md - 名字MCP 阅读
- 描述：MCP文档和自述文件
- mime类型:
text/markdown
此资源允许客户端直接通过服务器读取MCP文档。
安全说明
⚠️ 警告：此服务器允许执行任意shell命令。请谨慎使用，仅在受信任的环境中使用。
依赖项
mcp[cli]>=1.13.0-MCP Python SDK
