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

mcpserve-by-@ryaneggz

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

article

README

🚀 由 @ryaneggz 开发的 MCPServe

简单 MCP 服务器,附带 Shell 执行功能。可通过 Ngrok 连接到本地,也能在 Docker 中托管 Ubuntu24 容器

📖 目录

🚀 快速开始

本部分将介绍 MCP 的安装与使用方法,包含本地安装和 Docker 托管两种方式。

📦 安装指南

本地安装 MCP

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

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

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

## 启动本地 MCPServe
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. 补齐环境变量后重启客户端