Back to MCP directory
publicPublicdnsLocal runtime

mcp-sse

一个简单的MCP服务器项目,支持本地通过Ngrok连接或Docker容器部署,提供Shell执行功能。

article

README

🚀 🤖 MCPServe

MCPServe 是一款由 @ryaneggz 开发的简单 MCP 服务器,具备 Shell 执行功能。它支持通过 Ngrok 连接到本地,也能在 Docker 中托管 Ubuntu24 容器。

🚀 快速开始

部署文档

你可以查看部署文档了解更多部署相关信息。

📦 安装指南

在本地托管 MCP

## 安装 uv(如果你不使用,那你错过了派对)
curl -LsSf https://astral.sh/uv/install.sh | sh

## 创建虚拟环境
uv venv
source .venv/bin/activate

## 安装依赖项
uv pip install -r requirements.txt

## 启动本地 MCP 服务
python main.py

在 Docker 中托管 MCP

docker compose up --build

💻 使用示例

客户端 MCP 配置

如果你在代码中启用了服务器端的身份验证,则可以启用 API 的头文件。这可能需要对 MCP 库进行一些代码修改,例如添加中间件属性。

{
  "terminal": {
    "transport": "sse",
    "url": "http://localhost:8005/sse",
    // "headers": {
    //     "x-api-key": "abcdef123456..."
    // }
  }
}

🚀 路线图

  • [ ] 🤖 即将推出...

如果希望在路线图中看到某个功能,请提交问题并开始讨论。

💡 问题反馈

随时提交问题和改进请求。我们一直欢迎反馈和建议。

🤓 维护者

  • Ryan Eggleston - @ryaneggz

📄 许可证

此项目为开源,根据 MIT License 授权。请自由使用、修改和分发代码。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client