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 장 참조).
메인 저장소에서 원본을 수정할 때마다:
메인 저장소 commit + push
cp backend/addons/_mcp_shared/mrmodel_common.py ../mr-model-mcp/backend/mrmodel_common.pyMCP 저장소 commit + push
배포 순서: 먼저 메인 저장소 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.shdeploy-mcp.sh 7단계: service 백업 → 코드 pull → venv → 문법 검사 → 재시작 → 헬스 체크 → 실패 시 롤백.
문제 해결
증상 | 확인 방법 |
8868이 뜨지 않음 |
|
healthz가 5초 내에 200이 아님 | deploy-mcp.sh가 자동으로 git revert + restart |
5개 tools 모두 401 | 메인 저장소 sessions 테이블에 유효한 token 없음(먼저 메인 사이트에 로그인해 token을 받은 후 재시도) |
SQLite lock | 메인 저장소 |
Caddy 502 |
|
5가지 MCP 도구
도구 | 용도 |
| 블로거/태그/시간 범위로 동영상 목록 조회 |
| 동영상 댓글 조회(좋아요/시간/AI 태그 포함) |
| 동영상 OCR 텍스트 전문 검색 |
| 통합 검색(제목/소개/태그) |
| 블로거의 과거 의견 조회(변증법에 사용) |
자세한 내용은 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
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-