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에 막히지 않으려 함

향후 중국 내 Tencent Cloud 마이그레이션

먼저 저장소를 분리해야 함. 그렇지 않으면 메인 사이트 + 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(schema가 변경될 수 있음) → 그다음 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단계: service 백업 → 코드 pull → venv → 문법 검사 → 재시작 → 헬스 체크 → 실패 시 롤백.

문제 해결

증상

확인 방법

8868이 뜨지 않음

journalctl -u mr-model-mcp -n 50으로 systemd 로그 확인

healthz가 5초 내에 200이 아님

deploy-mcp.sh가 자동으로 git revert + restart

5개 tools 모두 401

메인 저장소 sessions 테이블에 유효한 token 없음(먼저 메인 사이트에 로그인해 token을 받은 후 재시도)

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의 각 tool 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