Skip to main content
Glama
deenesjakoruzh
Cesario121125

mr-model MCP Server

by Cesario121125
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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

リポジトリ構造

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 分離）

This server cannot be installed

-
license - not tested
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • clipkit

    MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.

  • mcp

    A Model Context Protocol server for Wix AI tools

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Cesario121125/mr-model-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server