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

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

먼저 저장소를 분리해야 함. 그렇지 않으면 메인 사이트 + 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(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 분리)

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
      -