🤖 MCPServe by @ryaneggz

📖 基本能力

产品定位

MCPServe 是一个简单的 MCP 服务器，主要用于通过 Shell 执行命令，支持本地和 Docker 环境部署。

核心功能

1. 支持通过 Shell 执行命令。
2. 可以通过 Ngrok 连接到本地。
3. 支持在 Docker 中托管 Ubuntu24 容器。
4. 提供 SSE（Server-Sent Events）传输方式。

适用场景

1. 需要在本地或 Docker 环境中快速部署 MCP 服务器的场景。
2. 需要通过 Shell 执行命令的开发或测试场景。
3. 需要使用 SSE 进行数据传输的场景。

工具列表

1. uv：用于创建虚拟环境和安装依赖。
2. Docker：用于托管 Ubuntu24 容器。
3. Ngrok：用于连接到本地服务。

常见问题解答

1. 如何启用 API 头：需要在代码中配置 auth 服务器端，并添加 middleware 属性。
2. 如何提交问题或功能请求：可以通过提交 issue 来反馈问题或建议新功能。

🛠️ 使用教程

使用依赖

1. 安装 uv（如果尚未安装）：

curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

1. 创建虚拟环境并激活：

uv venv
source .venv/bin/activate

1. 安装依赖：

uv pip install -r requirements.txt

1. 启动本地 MCPServe：

python main.py

Docker 安装

1. 构建并启动 Docker 容器：

docker compose up --build

调试方式

1. 检查本地服务是否正常运行：

python main.py

1. 检查 Docker 容器是否正常运行：

docker ps

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。