Skip to main content
Glama
mr-model MCP Server

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 章を参照)。

メインリポジトリがソースを変更するたびに:

  1. メインリポジトリ で commit + push

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

  3. MCP リポジトリで commit + push

  4. デプロイ順序:最初にメインリポジトリを 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.sh

deploy-mcp.sh の 7 ステップ:サービスをバックアップ → コード取得 → venv → 構文チェック → 再起動 → ヘルスチェック → 失敗時ロールバック。

トラブルシューティング

症状

調査

8868 が起動しない

journalctl -u mr-model-mcp -n 50 で systemd ログを確認

healthz が 5 秒以内に 200 以外

deploy-mcp.sh が自動で git revert + restart

5 ツールすべて 401

メインリポジトリの sessions テーブルに有効なトークンがない(先にメインサイトでログインしてトークンを取得)

SQLite lock

メインリポジトリの mrmodel.db を使用。並行処理は busy_timeout=15s で担保

Caddy 502

systemctl status caddy + caddy reload

5 つの MCP ツール

ツール

用途

query_video_list

ブロガー/タグ/時間帯で動画リストを取得

query_comments

動画コメントを取得(いいね/時間/AI タグ付き)

search_video_transcripts

動画 OCR テキストを全文検索

search_videos

総合検索(タイトル/概要/タグ)

query_blogger_opinions

ブロガーの過去の意見を取得(弁証法用)

詳細は 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

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      A 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.
      11
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 PyPI
      2
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides tools for parsing and retrieving Bilibili video information, including video details, download links, and collection listings.
      5
      18 npm
      1
      -