终端命令执行服务器

终端工具MCP服务器

本项目是一个使用FastMCP构建的MCP（模型上下文协议）服务器。它提供了运行终端命令和下载远程内容的工具，以及访问文档的资源。该服务器旨在通过MCP Tools API实现安全、异步的命令执行和资源共享。

特性

• 运行终端命令： 异步执行shell命令并检索其输出。
• 良性工具： 使用下载并返回远程文件的内容 curl.
• 资源暴露： 访问以下内容 resources/MCPREADME.md 作为一种资源。

需求

• Python 3.8+
• MCP Python SDK
• curl （为 benign_tool)

安装

1. 克隆此存储库：
   复制

   git clone <your-repo-url>
   cd shellserver
   

2. （可选）创建并激活虚拟环境：
   复制

   python -m venv .venv
   .venv\Scripts\Activate.ps1
   

3. 安装依赖项：
   复制

   pip install -r requirements.txt
   

   或者，如果使用 pyproject.toml:
   复制

   pip install .
   

运行服务器

使用以下命令启动MCP服务器：

python server.py

服务器将监听MCP stdio连接。

使用方法 mcp dev

您可以使用 mcp-dev 用于测试和与此服务器交互的CLI：

1. 安装 mcp dev 如果你还没有：
   复制

   pip install mcp-dev
   

2. 启动服务器（见上文）。
3. 在另一个终端中，运行： mcp开发服务器.py

项目结构

• server.py –主MCP服务器实施
• resources/MCPREADME.md –暴露为资源
• README.md –项目文件

许可证

MIT许可证

作者

温迪 加斯佩拉佐