Phocinae MCP server

<!-- mcp-name: io.github.Phocinae/phocinae-mcp -->

phocinae-mcp

把斑海豹的命令审批门与 P0 推理协议暴露为 MCP 工具（gate / classify / route / score），接入只读 MCP 的编码代理。双代协议并存：现代面（2026-07-28，含 server/discover、MRTR 交互、Streamable HTTP）与 2024-11-05 旧客户端兼容。

▲ tools/list 的真实应答：四个工具的参数与返回形状

斑海豹生态的 MCP server：把斑海豹的命令审批与推理能力以 4 个工具暴露给 MCP 客户端。纯标准库（Python ≥ 3.8，零第三方依赖），支持 stdio 与 Streamable HTTP 两种传输，MCP 2026-07-28 对齐并兼容 2024-11-05 旧客户端。

本仓库为本地增强版（基于 PyPI phocinae-mcp 0.1.1），仅用于本地开发与

协议对齐验证，不发布。

工具

▲ 合成演示动画（模型仓 docs/gallery S07）：画面为逐帧渲染、场景数据虚构，但它演示的 route 工具「一次前向在候选工具里选出该用的那个」的判定过程 与真实实现一致（本页上方的终端截图即真实运行的同一流程）。

fail-closed：斑海豹 P0 服务（/v1/systemone）不可用、超时、应答异常时， gate 一律返回 deny（带原因），classify/route/score 返回 isError: true。

传输方式

stdio（默认）

python3 -m phocinae_mcp --server http://127.0.0.1:8155

MCP 客户端以子进程方式拉起，走 stdin/stdout 逐行 JSON-RPC 帧。 stdout 纯净性保证：stdout 只输出 JSON-RPC 帧；一切日志（启动、告警、 工具内部异常）只走 stderr（phocinae-mcp[level]: 前缀）。guard.py 导入期 的打印也被重定向到 stderr，不会污染协议通道。

Streamable HTTP（新增，2026-07-28）

python3 -m phocinae_mcp --transport http --host 127.0.0.1 --port 8255
# --port 0 → 随机端口（测试用）；端口号打印在 stderr

其他地址直接拒绝启动（exit 2）；

• 仅回环绑定：--host 只接受 127.0.0.1 / localhost / ::1，

单对象 JSON；

• 端点 POST /mcp；通知 → 202 Accepted（空 body）；请求 → 200

支持（否则 400 + -32020/-32022）、Mcp-Method 必带且等于 body 的 method（tools/call、resources/read 还必带 Mcp-Name 等于 name/uri），违者 400 -32020；Accept 未含 application/json / text/event-stream → 406；未知方法 → 404 -32601；GET/DELETE → 405（2026-07-28 已移除 GET 流与会话终结端点）；

• 请求头强制（Server Validation）：MCP-Protocol-Version 必带且须受

• 无会话头（Mcp-Session-Id）、无 SSE 恢复缓冲——无状态服务，可任意重启。

环境变量：PHOCINAEMCPTRANSPORT=stdio|http、PHOCINAEMCPHTTP_PORT 可替代命令行开关。

协议对齐（2026-07-28）

双代并存，按请求逐条分派：

server/discover、resources/ → 现代面**；

• 带 params.meta（含 io.modelcontextprotocol/ 键）的请求、以及

与原版 0.1.x 一致）。

• initialize 握手、无 meta 的请求 → 旧年代**（2024-11-05 行为，

现代面补足项：

Shortened. The full README is on GitHub.