korean-law-mcp 部署指南：Docker 自托管、HTTP stateless 模式与 fly deploy 禁用原因全解

korean-law-mcp 部署指南Docker 自托管、HTTP stateless 模式与 fly deploy 禁用原因全解【免费下载链接】korean-law-mcp법제처 국가법령정보를 LLM에서 바로 조회하는 MCP 서버. 법령·판례·조례 검색과 인용 검증 | MCP server for Korean law — search statutes, precedents, and ordinances, and verify citations项目地址: https://gitcode.com/gh_mirrors/ko/korean-law-mcpkorean-law-mcp 是一款韩国法律 MCP 服务器MCP server可将韩国法制处国家法令信息直接接入大模型支持法令・判例・条例搜索与引用验证。本文带你完成 korean-law-mcp 部署的完整流程Docker 自托管一键上线、HTTP stateless 模式的工作原理以及为什么在统一主机上直接执行fly deploy会杀死五个服务——一篇讲清部署、原理与避坑。一、部署前 30 秒认识 korean-law-mcp99 个内部工具 → 10 个统一入口legal_research、legal_analysis、search_law、search_decisions等覆盖 1,600 部现行法律与海量判例传输方式STDIO本地与HTTP stateless远程双模式自托管需求想用自己的法제처 API Key、把服务放在内网或不想走公共远程端点时就需要自己部署二、Docker 自托管从拉取到上线只需 3 条命令1. 构建镜像仓库根目录已内置生产级 Dockerfile采用两阶段构建Alpine 固定 digest 的 Node 22.12并显式跳过 OCR/ML 可选依赖的下载保证镜像轻量git clone https://gitcode.com/gh_mirrors/ko/korean-law-mcp cd korean-law-mcp docker build -t korean-law-mcp .2. 运行容器含认证配置docker run -d \ -e LAW_OC你的法제처APIKey \ -e MCP_HTTP_HOST0.0.0.0 \ -e MCP_AUTH_TOKEN替换为随机强密码 \ -p 3000:3000 \ --name korean-law-mcp korean-law-mcp⚠️ 两个必填项环境变量作用LAW_OC韩国法制处 Open API Key免费申请缺了它所有查询都走不通MCP_AUTH_TOKEN客户端访问令牌。Dockerfile 默认绑定0.0.0.0不设令牌容器会直接拒绝启动除非显式加MCP_ALLOW_UNAUTHENTICATED_REMOTE1放弃认证认证逻辑在 src/server/http-config.ts 启动时 fail-fast 校验避免配错一个字母就静默无认证。3. 验证健康检查curl http://localhost:3000/health # {status:ok,timestamp:...}镜像内已内置HEALTHCHECK每 30 秒探活/healthdocker ps中显示healthy即部署成功。MCP 端点为/mcp客户端连接时通过x-mcp-token或Authorization: Bearer头携带令牌。三、HTTP stateless 模式为什么重启、扩容都零丢失普通 HTTP MCP 服务器会维护会话 Map 事件存储一旦进程 OOM 重启所有客户端会话全部作废。korean-law-mcp 在 v3.3.0 彻底转向stateless无状态模式核心做法在 src/server/http-server.ts每个 POST 请求新建Server Transport请求结束立即销毁——不保留任何会话内存sessionIdGenerator: undefined即 MCP 官方的 stateless 模式开关因此GET/DELETE /mcp 一律返回 405无会话可查询、可注销附带福利重启免疫、可水平扩容、无内存泄漏API Key 通过AsyncLocalStorage按请求隔离并发安全对自托管者的实际意义内存可以压得很低Fly 上 256MB 即可运行且随时docker restart都不会让客户端掉线。四、统一主机上的大坑为什么禁止直接fly deploy这是本文最反直觉的一节。看仓库里的 fly.toml.disabled——配置文件被故意禁用了原因记录在 docs/FLY-COST.md从 2026-07-02 起生产环境的 Fly 应用korean-law-mcp已不再只跑法律服务而是gomdori-mcp 统一主机一台 512MB 的机器同时承载law / stats / patent / archhub / school 共 5 个 MCP 服务按/law、/stats等路径分流若在本仓库直接fly deploy会用法律单机镜像覆盖统一镜像其余 4 个服务当场全灭⚠️ 本仓库 fly.toml → fly.toml.disabled2026-07-02 起 部署走统一主机仓库更新 npm 版本固定值 → 在 gomdori-mcp 仓库 fly deploy这条纪律写进了 CLAUDE.md 的醒目警告区。对普通自托管者而言结论很简单你自己的 Docker 部署完全不受影响——禁用只针对官方那台共享生产机。 顺带一提统一主机的月成本从 $16 优化到约 $0$5 以下免单核心就是5 个 MCP 合并到 1 台机器 删掉重复机器。想深入看诊断过程读 docs/FLY-COST.md 即可。五、生产加固清单5 个值得设置的环境变量变量默认建议RATE_LIMIT_RPM60按客户端 IP 限流公共暴露可调大FALLBACK_RATE_LIMIT_RPM120无自带 Key 请求走你LAW_OC的全局上限令牌桶FALLBACK_DAILY_CAP0关闭公共部署强烈建议设日总量保护你的 API 配额ALLOW_QUERY_API_KEY1设为0禁止?oc传 Key防代理日志泄露明文ALLOWED_ORIGINS未设浏览器端调用必配白名单DNS rebinding 防御六、部署后 5 分钟接入客户端claude.ai / Cursor 等支持远程 HTTP 的客户端填http://你的服务器:3000/mcp认证头带x-mcp-tokenClaude Desktop不支持远程 HTTP需经mcp-remote适配器中转CLI 验证curl -X POST http://localhost:3000/mcp -H x-mcp-token: 令牌 -H Content-Type: application/json -d {jsonrpc:2.0,id:1,method:tools/list}应返回 10 个工具列表总结 三步回顾docker build→ 带LAW_OCMCP_AUTH_TOKEN的docker run→curl /health确认 healthy。stateless 模式让你可以放心重启扩容而fly deploy禁令则提醒你官方生产机是 5 合 1 统一主机自托管请走自己的 Docker 路线。更多细节可参考 docs/API.md工具参考、docs/ARCHITECTURE.md系统架构与 Dockerfile构建细节。【免费下载链接】korean-law-mcp법제처 국가법령정보를 LLM에서 바로 조회하는 MCP 서버. 법령·판례·조례 검색과 인용 검증 | MCP server for Korean law — search statutes, precedents, and ordinances, and verify citations项目地址: https://gitcode.com/gh_mirrors/ko/korean-law-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考