Epr MCP Python

MCP运维云端

提供方 xbcsmith

运维云端 stdio · 本地进程 Token 社区 / 第三方
查看接入方式

EPR MCP Python是一个用于事件溯源注册服务器的Python MCP服务器,提供MCP工具和OpenAPI端点以与事件溯源注册表交互。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

事件溯源Python本地部署Python服务器MCP工具OpenAPI

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
python3 -m venv .venv/epr-mcp-python

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

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 10 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

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

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

部署与发布

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

监控与告警

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

选择建议

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

值得选的地方

  • 资料标注 10 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Epr MCP Python当前 10 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

服务器档案

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

详细介绍

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

EPR-MCP-Python

概述

EPR MCP Python 是一个用于事件溯源注册表(Event Provenance Registry)服务器的 Python MCP 服务器。

发展

本地开发```bash

git clone git@github.com:xbcsmith/epr-mcp-python.git
cd epr-mcp-python

python3 -m venv .venv/epr-mcp-python
source .venv/epr-mcp-python/bin/activate

pip install -e .


### Docker 开发

#### 选项1:Docker Compose(推荐)```bash
git clone git@github.com:xbcsmith/epr-mcp-python.git
cd epr-mcp-python

# Copy and configure environment
cp .env.example .env
# Edit .env with your EPR_URL and EPR_TOKEN

# Start with Docker Compose
docker-compose up -d

# View logs
docker-compose logs -f epr-mcp-server

选项2:直接运行Docker```bash

git clone git@github.com:xbcsmith/epr-mcp-python.git
cd epr-mcp-python

Build the Docker image

docker build -t epr-mcp-server .

Run with environment variables

docker run -d \
--name epr-mcp-server \
-p 8000:8000 \
-e EPR_URL=http://host.docker.internal:8042 \
-e EPR_TOKEN=your-epr-api-token \
-e EPR_DEBUG=false \
epr-mcp-server

View logs

docker logs -f epr-mcp-server

Stop the container

docker stop epr-mcp-server
docker rm epr-mcp-server


#### Docker 运行选项

**基本运行:**```bash
docker run -p 8000:8000 \
-e EPR_URL=http://host.docker.internal:8042 \
-e EPR_TOKEN=your-token \
epr-mcp-server

对于原木的体积:```bash
docker run -p 8000:8000 \
-v $(pwd)/logs:/app/logs \
-e EPR_URL=http://host.docker.internal:8042 \
-e EPR_TOKEN=your-token \
epr-mcp-server


**交互模式(用于调试):**```bash
docker run -it --rm \
-p 8000:8000 \
-e EPR_URL=http://host.docker.internal:8042 \
-e EPR_TOKEN=your-token \
epr-mcp-server

重要提示: 在Docker中运行时,EPR_URL必须指向正确的地址:

  • 如果EPR服务器运行在主机上: EPR_URL=http://host.docker.internal:8042
  • 如果EPR服务器在容器中运行: EPR_URL=http://container-name:8042

看 docker_compose.md(文件名,可译为“docker_compose.md文档”或根据上下文简化为“docker_compose.md”) 以获取详细的 Docker Compose 文档。

开发依赖项```bash

pip install -e .[lint,test,build]


## Makefile```text
install         Installs epr-mcp-python into a virtualenv called epr-mcp
lint            Run linter (requires ruff)
tests           Run tests
release         Run tox
wheel           Create an sdist bdist_wheel
clean           Cleanup everything

使用方法

EPR MCP服务器提供了MCP工具和OpenAPI端点,用于与事件溯源注册表进行交互。

MCP 工具

服务器根据OpenAPI规范自动生成MCP工具:

  • fetchEvent - 通过ID获取事件
  • fetchReceiver - 通过ID获取事件接收器
  • fetchGroup - 通过ID获取事件接收器组
  • createEvent - 创建一个新事件
  • createReceiver - 创建一个新的事件接收器
  • createGroup - 创建一个新的事件接收器组
  • searchEvents - 搜索活动
  • searchReceivers - 搜索事件接收器
  • searchGroups - 搜索事件接收器组
  • healthCheck - 健康检查端点

OpenAPI 端点

当服务器运行时,可访问以下OpenAPI端点:

  • 开放API规范:

  • YAML 格式: http://localhost:8000/openapi.yaml

  • JSON 格式: http://localhost:8000/openapi.json

  • API 文档:

  • Swagger UI: http://localhost:8000/docs

  • 健康检查:

  • http://localhost:8000/health

示例用法```python

Using MCP tools

mcp.call_tool('fetchEvent', {'id': 'event-123'})

mcp.call_tool('searchEvents', {
'name': 'deployment',
'version': '1.0.0'
})

mcp.call_tool('createEvent', {
'name': 'test-event',
'version': '1.0.0',
'release': '1.0.0',
'platform_id': 'linux',
'package': 'test-package',
'description': 'Test event',
'event_receiver_id': 'receiver-123',
'success': True,
'payload': {'key': 'value'}
})


### VSCode

#### HTTP传输配置```json
"mcp": {
"servers": {
"epr-mcp-server": {
"type": "http",
"url": "http://localhost:8000/mcp"
}
}
}

Docker 配置(备选方案)

如果通过Docker运行,您可以使用以下配置:```json
"mcp": {
"servers": {
"epr-mcp-server": {
"command": "docker",
"args": [
"run",
"-d",
"--rm",
"--network=host",
"-e",
"EPR_URL=${input:epr_url}",
"-e",
"EPR_TOKEN=${input:epr_token}",
"epr-mcp-python:latest"
],
"type": "http",
"url": "http://localhost:8000/mcp"
}
},
"inputs": [
{
"type": "promptString",
"id": "epr_token",
"description": "EPR API Token",
"password": true
},
{
"type": "promptString",
"id": "epr_url",
"description": "EPR URL",
"default": "http://localhost:8042",
"password": false
}
]
}


#### 本地开发配置

对于本地开发,请先启动服务器,然后使用以下配置:```json
"mcp": {
"servers": {
"epr-mcp-server": {
"type": "http",
"url": "http://localhost:8000/mcp",
"env": {
"EPR_URL": "${input:epr_url}",
"EPR_TOKEN": "${input:epr_token}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "epr_token",
"description": "EPR API Token",
"password": true
},
{
"type": "promptString",
"id": "epr_url",
"description": "EPR URL",
"default": "http://localhost:8042",
"password": false
}
]
}

启动服务器

在使用VSCode集成之前,请先启动EPR MCP服务器:```bash

Set environment variables

export EPR_URL="http://your-epr-server:8042"
export EPR_TOKEN="your-api-token"

Start the server

python -m epr_mcp.main start


服务器将在 `http://localhost:8000/mcp` 用于MCP连接和 `http://localhost:8000/docs` 为API文档。

#### 运行MCP检查器```bash
npx @modelcontextprotocol/inspector

故障排除

遇到连接问题?请参阅 故障排除指南 以获取常见问题的详细解决方案。

Docker的快速修复方案:

  • 连接失败错误:请使用 EPR_URL=http://host.docker.internal:8042 在你的 .env 文件
  • 检查EPR服务器是否正在运行: curl http://localhost:8042/health
  • 查看日志: docker-compose logs -f epr-mcp-server

文档

  • Docker 设置指南 - Docker Compose 和直接使用 Docker
  • Docker 快速参考指南 - 常用的Docker命令及示例
  • 故障排除指南 - 常见问题的解决方案
  • OpenAPI 实现
  • 模式验证

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Epr MCP Python 怎么安装?

在客户端按下面的安装命令接入:python3 -m venv .venv/epr-mcp-python。装完在客户端配置里引用同一个包或端点。

Epr MCP Python 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Epr MCP Python 收费吗?

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

Epr MCP Python 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Epr MCP Python 能提供哪些能力?

资料显示约 10 个工具;能力标签包括 API集成、Python、Python服务器、Token认证。具体工具清单以官方文档为准。

Epr MCP Python 需要什么运行环境?

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

Epr MCP Python 是本地还是远程?

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

热门专题

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

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