返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端