zeroMCP (Mrexodia)

MCP运维云端

提供方 mrexodia

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 ClaudeCursorWindsurfCline
查看接入方式

zeromcp是一个轻量级的纯Python实现的MCP服务器,专注于通过清晰的Python类型注释暴露工具。

一句话选型结论

按资料字段整理

zeroMCP (Mrexodia) 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude、Cursor、Windsurf 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 77 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

轻量级Python本地部署类型安全高性能HTTP/SSE传输工具暴露

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install zeromcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Windsurf,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
zeroMCP (Mrexodia)当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方mrexodia上游标注的维护方 mrexodia
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.4 KB
来自项目仓库与上游目录的原文,未做删改

zeromcp

纯Python中最小的MCP服务器实现。

一种轻量级的手工实现 模型上下文协议 专注于大多数用户实际需要的东西:使用干净的Python类型注释公开工具。

特性

  • ✨ 零依赖 -纯Python,仅标准库
  • 🎯 类型安全 -所有内容的原生Python类型注释
  • 🚀 快速 -开销最小,性能最高
  • 🛠️ 手工制作的 -由人类书写1,根据规范进行验证
  • 🌐 HTTP/SSE传输 -可简化的响应
  • 📡 标准运输 -对于传统客户
  • 📦 微小 -少于1000行代码

安装```bash

pip install zeromcp


或者使用紫外线:```bash
uv add zeromcp

快速开始```python

from typing import Annotated
from zeromcp import McpServer

mcp = McpServer("my-server")

@mcp.tool
def greet(
name: Annotated[str, "Name to greet"],
age: Annotated[int | None, "Age of person"] = None
) -> str:
"""Generate a greeting message"""
if age:
return f"Hello, {name}! You are {age} years old."
return f"Hello, {name}!"

if name == "main":
mcp.serve("127.0.0.1", 8000)


然后使用手动测试您的MCP服务器 检查员:```bash
npx -y @modelcontextprotocol/inspector

一旦一切正常,您就可以配置 mcp.json:```json
{
"mcpServers": {
"my-server": {
"type": "http",
"url": "http://127.0.0.1:8000/mcp"
}
}
}


## 标准运输

对于仅支持stdio传输的MCP客户端:```python
from zeromcp import McpServer

mcp = McpServer("my-server")

@mcp.tool
def greet(name: str) -> str:
"""Generate a greeting"""
return f"Hello, {name}!"

if __name__ == "__main__":
mcp.stdio()

然后在中配置 mcp.json (每个客户都不一样):```json
{
"mcpServers": {
"my-server": {
"command": "python",
"args": ["path/to/server.py"]
}
}
}


## 类型注解

zeromcp使用原生Python `Annotated` 用于模式生成的类型:```python
from typing import Annotated, Optional, TypedDict, NotRequired

class GreetingResponse(TypedDict):
message: Annotated[str, "Greeting message"]
name: Annotated[str, "Name that was greeted"]
age: Annotated[NotRequired[int], "Age if provided"]

@mcp.tool
def greet(
name: Annotated[str, "Name to greet"],
age: Annotated[Optional[int], "Age of person"] = None
) -> GreetingResponse:
"""Generate a greeting message"""
if age is not None:
return {
"message": f"Hello, {name}! You are {age} years old.",
"name": name,
"age": age
}
return {
"message": f"Hello, {name}!",
"name": name
}

联合类型

工具可以接受多种输入类型:```python
from typing import Annotated, TypedDict

class StructInfo(TypedDict):
name: Annotated[str, "Structure name"]
size: Annotated[int, "Structure size in bytes"]
fields: Annotated[list[str], "List of field names"]

@mcp.tool
def struct_get(
names: Annotated[list[str], "Array of structure names"]
| Annotated[str, "Single structure name"]
) -> list[StructInfo]:
"""Retrieve structure information by names"""
return [
{
"name": name,
"size": 128,
"fields": ["field1", "field2", "field3"]
}
for name in (names if isinstance(names, list) else [names])
]


## 错误处理```python
from zeromcp import McpToolError

@mcp.tool
def divide(
numerator: Annotated[float, "Numerator"],
denominator: Annotated[float, "Denominator"]
) -> float:
"""Divide two numbers"""
if denominator == 0:
raise McpToolError("Division by zero")
return numerator / denominator

资源

通过URI模式公开只读数据。资源被序列化为JSON。```python
from typing import Annotated

@mcp.resource("file://data.txt")
def read_file() -> dict:
"""Get information about data.txt"""
return {"name": "data.txt", "size": 1024}

@mcp.resource("file://{filename}")
def read_any_file(
filename: Annotated[str, "Name of file to read"]
) -> dict:
"""Get information about any file"""
return {"name": filename, "size": 2048}


## 鼓励

公开具有类型化参数的可重用提示模板。````python
from typing import Annotated

@mcp.prompt
def code_review(
code: Annotated[str, "Code to review"],
language: Annotated[str, "Programming language"] = "python"
) -> str:
"""Review code for bugs and improvements"""
return f"Please review this {language} code:\n\n```{language}\n{code}\n```"
````

## 跨域资源共享

默认情况下,zeromcp允许来自本地主机的CORS请求(`localhost`, `127.0.0.1`, `::1`)on **任何端口**。这允许MCP检查器或本地AI工具等工具与您的MCP服务器通信。```python
from zeromcp import McpServer

mcp = McpServer("my-server")

# Default: allow localhost on any port
mcp.cors_allowed_origins = mcp.cors_localhost

# Allow all origins (use with caution)
mcp.cors_allowed_origins = "*"

# Allow specific origins
mcp.cors_allowed_origins = [
"http://localhost:3000",
"https://myapp.example.com",
]

# Disable CORS (blocks all browser cross-origin requests)
mcp.cors_allowed_origins = None

# Custom logic
mcp.cors_allowed_origins = lambda origin: origin.endswith(".example.com")

注意:CORS仅影响基于浏览器的请求。非浏览器客户端,如 curl 或MCP桌面应用程序不受此设置的影响。

支持的客户

以下客户端已经过测试:

  • 克劳德代码
  • 克劳德桌面版 (仅限stdio)
  • Visual Studio Code
  • Roo代码 / 克莱恩 / 基洛代码
  • LM工作室
  • 一月
  • 双子星命令行工具
  • 光标
  • 帆板运动
  • 泽德 (仅限stdio)
  • 曲速

备注:一般来说 /mcp 端点是首选,但并非所有客户端都正确支持它。

1README和Claude编写的一些测试

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
zeroMCP (Mrexodia) 怎么安装?

在客户端按下面的安装命令接入:pip install zeromcp。装完在客户端配置里引用同一个包或端点。

zeroMCP (Mrexodia) 怎么在 Claude、Cursor、Windsurf 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

zeroMCP (Mrexodia) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

zeroMCP (Mrexodia) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

zeroMCP (Mrexodia) 支持哪些客户端?

资料标注支持 Claude、Cursor、Windsurf、Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

zeroMCP (Mrexodia) 能提供哪些能力?

资料显示能力标签包括 轻量级、高性能、Python、Claude。具体工具清单以官方文档为准。

zeroMCP (Mrexodia) 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

zeroMCP (Mrexodia) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。