mr-model MCP Server
mr-model MCP eigenständiger Dienst
Der eigenständige MCP-Dienst (Model Context Protocol) der mr-model-Plattform, aus dem Haupt-Repository mr-model ausgegliedert.
Hauptdienst (8866):
mrmodel.cesario.top— Web/API/Mitglieder/Zahlung/PushMCP-Dienst (dieses Repository, 8868):
mcp.cesario.top— 5 Model Context Protocol Tools
Warum die Ausgliederung
Motivation | Details |
Stabile unabhängige Upgrades | MCP möchte seinen eigenen Iterationsrhythmus haben, ohne durch PRs der Hauptseite blockiert zu werden |
Zukünftige Migration zu Tencent Cloud in China | Das Repository muss zuerst ausgegliedert werden, sonst verdoppeln sich die Kosten, wenn Hauptseite + MCP zusammen migriert werden |
Geschäft zu 90 % unabhängig | systemd / Port / Domain / Caddy / Restart sind längst unabhängig, es fehlen nur noch Code-Repository + venv |
Related MCP server: video-toolkit-mcp
Repository-Struktur
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 反代配置Gemeinsamer Code mit dem Haupt-Repository
backend/mrmodel_common.py ist eine Kopie aus dem Haupt-Repository backend/addons/_mcp_shared/mrmodel_common.py.
Pragmatische DRY-Strategie: Das Haupt-Repository ist die Quelle, das MCP-Repository ist die Kopie, manuelle cp-Synchronisierung (siehe [[../mr-model/docs/mr-model-扩展包架构方案-2026-08-19]] Abschnitt C).
Jedes Mal, wenn das Haupt-Repository die Quelle ändert:
Haupt-Repository commit + push
cp backend/addons/_mcp_shared/mrmodel_common.py ../mr-model-mcp/backend/mrmodel_common.pyMCP-Repository commit + push
Bereitstellungsreihenfolge: zuerst Haupt-Repository deployen (Schema kann sich ändern) → dann MCP-Repository deploy-mcp.sh
Entwicklung (lokal)
# 准备 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/healthzBereitstellung (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.shdeploy-mcp.sh in 7 Schritten: Service sichern → Code ziehen → venv → Syntaxprüfung → Neustart → Health-Check → Rollback bei Fehler.
Fehlerbehebung
Symptom | Untersuchung |
8868 startet nicht |
|
healthz liefert innerhalb von 5 s nicht 200 | deploy-mcp.sh macht automatisch git revert + restart |
Alle 5 Tools liefern 401 | Kein gültiges Token in der sessions-Tabelle des Haupt-Repositorys (zuerst auf der Hauptseite anmelden, um ein Token zu erhalten, dann erneut versuchen) |
SQLite lock | Läuft über |
Caddy 502 |
|
Die 5 MCP-Tools
Tool | Zweck |
| Videoliste nach Blogger/Tag/Zeitfenster abfragen |
| Videokommentare abfragen (mit Likes/Zeit/AI-Tags) |
| Volltextsuche in Video-OCR-Texten |
| Umfassende Suche (Titel/Beschreibung/Tags) |
| Historische Meinungen des Bloggers abfragen (für Dialektik) |
Details siehe docstring jedes Tools in backend/mcp_server.py.
Wartung
Version: Folgt dem Rhythmus des Haupt-Repositorys, keine eigene Versionsnummer
Rollback:
git revert HEAD+bash deploy-mcp.shÜberwachung: mcp_addon des Haupt-Repositorys
/api/_addon/mcp/healthzprüft die Erreichbarkeit von 8868
Erstellt am 2026-08-19 (mr-model B-Stufe MCP-Ausgliederung)
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Hosted MCP server for DataLikers — Instagram & TikTok data API. 51 tools: Instagram user search by demographics (gender/age/race/country/city), profiles, bulk lookup, engagement, posts & reels, comments, hashtags, locations, stories, highlights, music, business accounts, top users; TikTok users, videos, comments, hashtags, playlists and top charts. Streamable HTTP, Bearer API key. Free tier: 100 requests on signup at https://datalikers.com/p/1by27bwg
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables web search with category support, website content scraping with citation metadata, and timezone-aware date/time tools.55MIT
- AlicenseBqualityCmaintenanceA Model Context Protocol (MCP) server that provides comprehensive video tools: transcript retrieval, video downloading, and automatic subtitle generation using AI speech-to-text. Works with YouTube, Bilibili, Vimeo, and any platform supported by yt-dlp.11MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that downloads watermark-free videos from Douyin (TikTok China) share links, extracts audio, and transcribes speech to text using ASR APIs.24 PyPI2MIT
- FlicenseBqualityDmaintenanceA Model Context Protocol server that provides tools for parsing and retrieving Bilibili video information, including video details, download links, and collection listings.518 npm1-