MCPER
MCP Harness Server for LLM Agents
Rules · Skills · Workflows 를 버저닝된 중앙 저장소에서 LLM 클라이언트에 on-demand 로 공급
______________________________________________________________________
项目简介
MCPER包括Cursor AI、Claude Code、Codex、Copilot、Local LLM等 MCP兼容的LLM客户端在各项目·各团队 行为准则（Rules）、技能（Skills）、工作流程（Workflows） 是集中管理并按需供应的MCP服务器。基于FastAPI+FastMCP（Streamable HTTP），每个内容被燃烧到Global/Repository/App 3层。
______________________________________________________________________
构建和运行
Docker Compose（建议）
git clone https://github.com/Cha-Young-Ho/mcper.git
cd mcper/infra/docker
docker compose up -d --build- Web：
http://localhost:8001 - 管理用户界面：
http://localhost:8001/admin(admin/changeme)
健康检查:
curl http://localhost:8001/health本地开发（Python）
python3.13 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# Postgres · Redis 는 별도 기동 필요 (예: docker compose up db redis)
export DATABASE_URL=postgresql://user:password@localhost:5433/mcpdb
export CELERY_BROKER_URL=redis://localhost:6380/0
export PYTHONPATH=.
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000生产部署（HTTPS）
cd infra/docker
docker compose -f docker-compose.yml -f docker-compose.caddy.yml up -d --buildCaddy接管80/443，Let's Encrypt自动发放。 Caddyfile 将的域修改为您自己的域。
______________________________________________________________________
使用方法
1）在MCP客户端注册
光标 (~/.cursor/mcp.json):
{
"mcpServers": {
"mcper": { "url": "http://localhost:8001/mcp" }
}
}克劳德代码:
claude mcp add --transport http mcper http://localhost:8001/mcp操作环境（HTTPS+OAuth）：
claude mcp add --transport http mcper https:///mcp
# 첫 호출 시 브라우저로 OAuth 인증 페이지 열림2）从代理获取规则
在聊天窗口中使用自然语言请求：
이 프로젝트 룰 받아와 줘MCPER将Global+Repository+App规则返回一个标记。代理 CLAUDE.md 或者 .cursor/rules/... 自动保存到。
3）在Addmin UI中管理内容
http://localhost:8001/admin 登录后：
- 规则/技能/工作流程/文档 -全球、App、Repository类别CRUD
- 企划书 -特定于应用程序的卡（修改名称/删除内容/删除应用程序）
- 用户/RBAC -对于通过Google登录进入的用户
(도메인, 앱, role)授权 - 芹菜 -监视异步索引操作
4）首选参数（常用值）
| 变量 | 默认值 | 说明 |
|---|---|---|
DATABASE_URL | - | Postgres连接 |
CELERY_BROKER_URL | - | Redis（空时同步回退） |
ADMIN_USER / ADMIN_PASSWORD | admin / changeme | 主帐户 |
MCPER_AUTH_ENABLED | false | 启用用户身份验证 |
AUTH_SECRET_KEY | - | JWT/CSRF签名密钥（激活认证时必需） |
AUTH_GOOGLE_CLIENT_ID / AUTH_GOOGLE_CLIENT_SECRET | - | 设置时在登录页面上显示Google按钮 |
OAUTH_REDIRECT_BASE | http://localhost:8001 | OAuth回调默认URL |
EMBEDDING_PROVIDER | local | local/sidecar/openai/bedrock |
.env.local 将文件 infra/docker/ 如果放在中，Compose将自动加载。
______________________________________________________________________
了解更多
ARCHITECTURE.md-内部结构详细信息docs/SECURITY.md-认证·权限·CSRF·CORSdocs/RELIABILITY.md-运营、部署、规模CHANGELOG.md-变更历史记录