mr-model MCP Server
mr-model MCP 独立服务
mr-model プラットフォームの MCP(Model Context Protocol)独立サービス。メインリポジトリ mr-model から分離。
メインサービス(8866):
mrmodel.cesario.top—— Web/API/メンバー/決済/プッシュMCP サービス(本リポジトリ、8868):
mcp.cesario.top—— 5 つの Model Context Protocol ツール
なぜ分離するか
動機 | 詳細 |
安定した独立アップグレード | MCP は独自のイテレーションリズムで進め、メインサイトの PR にブロックされないようにする。 |
将来の国内テンセントクラウド移行 | まずリポジトリを分離しないと、メインサイト + MCP を一緒に移行するとコストが倍になる。 |
業務はすでに 90% 独立 | systemd / ポート / ドメイン / Caddy / Restart はすでに独立、残るはコードリポジトリ + venv |
Related MCP server: video-toolkit-mcp
リポジトリ構造
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 反代配置メインリポジトリとの共有コード
backend/mrmodel_common.py は、メインリポジトリ backend/addons/_mcp_shared/mrmodel_common.py をコピーしたものです。
DRY 実務戦略:メインリポジトリがソース、MCP リポジトリがコピー、手動 cp で同期([[../mr-model/docs/mr-model-扩展包架构方案-2026-08-19]] §C 章を参照)。
メインリポジトリがソースを変更するたびに:
メインリポジトリ で commit + push
cp backend/addons/_mcp_shared/mrmodel_common.py ../mr-model-mcp/backend/mrmodel_common.pyMCP リポジトリで commit + push
デプロイ順序:最初にメインリポジトリを deploy(スキーマが変わる可能性)→ 次に MCP リポジトリを deploy-mcp.sh
開発(ローカル)
# 准备 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デプロイ(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 の 7 ステップ:サービスをバックアップ → コード取得 → venv → 構文チェック → 再起動 → ヘルスチェック → 失敗時ロールバック。
トラブルシューティング
症状 | 調査 |
8868 が起動しない |
|
healthz が 5 秒以内に 200 以外 | deploy-mcp.sh が自動で git revert + restart |
5 ツールすべて 401 | メインリポジトリの sessions テーブルに有効なトークンがない(先にメインサイトでログインしてトークンを取得) |
SQLite lock | メインリポジトリの |
Caddy 502 |
|
5 つの MCP ツール
ツール | 用途 |
| ブロガー/タグ/時間帯で動画リストを取得 |
| 動画コメントを取得(いいね/時間/AI タグ付き) |
| 動画 OCR テキストを全文検索 |
| 総合検索(タイトル/概要/タグ) |
| ブロガーの過去の意見を取得(弁証法用) |
詳細は backend/mcp_server.py の各ツールの docstring を参照。
メンテナンス
バージョン:メインリポジトリのペースに従う、独立したバージョン番号なし
ロールバック:
git revert HEAD+bash deploy-mcp.sh監視:メインリポジトリの mcp_addon
/api/_addon/mcp/healthzが 8868 をプローブ
作成日 2026-08-19(mr-model B 档 MCP 分離)
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-