Servicio independiente MCP de mr-model

Servicio independiente MCP (Model Context Protocol) de la plataforma mr-model, separado del repositorio principal mr-model.

• Servicio principal (8866): mrmodel.cesario.top — Web/API/membresía/pago/notificaciones

• Servicio MCP (este repositorio, 8868): mcp.cesario.top — 5 herramientas de Model Context Protocol

Por qué separar

Estructura del repositorio

mr-model-mcp/
├── .env.example          # 环境变量模板（真实 .env 不入库）
├── README.md             # 本文件
├── requirements.txt      # 5 个精简依赖
├── deploy-mcp.sh         # 拉码/venv/语法/restart/verify/失败回滚
├── backend/
│   ├── mcp_server.py     # 1081 行，5 tools
│   ├── mcp_auth.py       # Bearer token 鉴权
│   ├── database.py       # 最小版（只 get_connection）
│   ├── user_service.py   # 最小版（只 _now_cst）
│   ├── membership_service.py  # 最小版（只 get_active_membership）
│   ├── agent_service.py  # 最小版（只 _labelize_text）
│   ├── config.py         # 最小版（MCP 需要的常量）
│   └── mrmodel_common.py # = 复制自主仓 addons/_mcp_shared/mrmodel_common.py
└── deploy/
    ├── mr-model-mcp.service  # systemd unit
    └── mcp.cesario.top.conf  # Caddy 反代配置

Código compartido con el repositorio principal

backend/mrmodel_common.py es una copia del repositorio principal backend/addons/_mcp_shared/mrmodel_common.py.

Estrategia pragmática DRY: el repositorio principal es la fuente, el repositorio MCP es la copia, sincronización manual con cp (ver sección §C de [[../mr-model/docs/mr-model-扩展包架构方案-2026-08-19]]).

Cada vez que el repositorio principal cambia la fuente:

1. commit + push en el repositorio principal

2. cp backend/addons/_mcp_shared/mrmodel_common.py ../mr-model-mcp/backend/mrmodel_common.py

3. commit + push en el repositorio MCP

4. Orden de despliegue: primero deploy del repositorio principal (el schema puede cambiar) → luego deploy-mcp.sh del repositorio MCP

Desarrollo (local)

# 准备 venv（首次）
python3 -m venv venv
venv/bin/pip install --upgrade pip
venv/bin/pip install -r requirements.txt

# 启动（默认 127.0.0.1:8868）
cp .env.example .env   # 按需改 DATABASE_PATH 指向主仓 DB
venv/bin/python3 backend/mcp_server.py

# 健康检查
curl http://127.0.0.1:8868/healthz

Despliegue (A1)

# 首次部署
sudo cp deploy/mr-model-mcp.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable mr-model-mcp
bash deploy-mcp.sh   # 第一次跑会建 venv（60-120s）

# 后续升级
bash deploy-mcp.sh

deploy-mcp.sh 7 pasos: respaldo del servicio → pull del código → venv → verificación de sintaxis → reinicio → verificación de salud → reversión en caso de fallo.

Solución de problemas

5 herramientas MCP

Ver el docstring de cada tool en backend/mcp_server.py.

Mantenimiento

• Versión: sigue el ritmo del repositorio principal, sin número de versión independiente

• Reversión: git revert HEAD + bash deploy-mcp.sh

• Monitoreo: el mcp_addon del repositorio principal verifica la salud de 8868 en /api/_addon/mcp/healthz

Creado el 2026-08-19 (división MCP del nivel B de mr-model)