プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。レビューとアカウント機能は今後のステップで始まります。
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Phocinae MCP

作者:Phocinaeバージョン 0.2.6i★ –iパソコンで動く
レジストリ名io.github.Phocinae/phocinae-mcp

インストール

概要

作者による説明(英語の原文)

Local Phocinae decision-engine MCP stdio server: fail-closed approval gate + classify/route/score.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: パソコンで動く
  • トランスポート: stdio
  • カテゴリ: その他

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

  • 基本チェック:1項目中1項目に合格
  • あなたのパソコンで、あなたのユーザーと同じ権限(ファイル、ネットワーク、アプリ)で動きます。
  • レジストリには、入力が必要なキーは載っていません。

必要なもの

  • PyPIPythonのuvのインストール(uvxコマンドに必要)

どのアプリを使っていますか?

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "phocinae": {
      "command": "uvx",
      "args": [
        "phocinae-mcp"
      ]
    }
  }
}

ターミナルでこれを実行します

claude mcp add phocinae -- uvx phocinae-mcp

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "phocinae": {
      "command": "uvx",
      "args": [
        "phocinae-mcp"
      ]
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "phocinae": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "phocinae-mcp"
      ]
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント Phocinae で確認済みです

  • … 未チェック

    今もメンテナンスされている

    このリポジトリはまだGitHubから読み取っていません

  • … 未チェック

    ライセンスがある

    このリポジトリはまだGitHubから読み取っていません

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

その他のほかのサーバーとの比較i

  • このカテゴリのほかの32583件のうち0%よりスターが多い
  • このカテゴリのほかの32583件のうち60%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの32583件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Phocinae MCPは安全ですか?

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は–、最新バージョン(0.2.6)がレジストリに届いたのは25 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:Spec Driven Development, Remote Desktop Commander, sync. labs

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Remote Desktop Commander

作者:desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

クラウドで動く★ 211昨日更新
インストール

sync. labs

作者:synchronicity-labs

Lipsync videos, dub them into other languages, make talking videos and open sync. Studio.

パソコンでもクラウドでも今日更新
インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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),仅用于本地开发与

协议对齐验证,不发布。

Install (local enhanced build)

git clone https://github.com/Phocinae/phocinae-mcp.git

cd phocinae-mcp python3 -m pip install . phocinae-mcp --help

This repository is a local enhanced build and is not the PyPI release; the registry entry and the package below refer to the same server contract.

工具

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

工具作用输入输出
gate判定 shell 命令能否执行command、cwd?、server?decision ∈ allow/deny/ask + layer/reason
classify把状态归入候选标签之一state、labels、server?choice(下标)+ label
route从候选工具中选最合适的一个state、tools、server?choice + tool
score按标准给状态打 2–10 分state、criteria、server?score + range

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

  • 仅回环绑定:--host 只接受 127.0.0.1 / localhost / ::1, 其他地址直接拒绝启动(exit 2);
  • 端点 POST /mcp;通知 → 202 Accepted(空 body);请求 → 200 单对象 JSON;
  • 请求头强制(Server Validation):MCP-Protocol-Version 必带且须受 支持(否则 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 流与会话终结端点);
  • 无会话头(Mcp-Session-Id)、无 SSE 恢复缓冲——无状态服务,可任意重启。

环境变量:PHOCINAE_MCP_TRANSPORT=stdio|http、PHOCINAE_MCP_HTTP_PORT 可替代命令行开关。

协议对齐(2026-07-28)

双代并存,按请求逐条分派:

  • 带 params._meta(含 io.modelcontextprotocol/* 键)的请求、以及 server/discover、resources/* → 现代面;
  • initialize 握手、无 _meta 的请求 → 旧年代(2024-11-05 行为, 与原版 0.1.x 一致)。

现代面补足项:

项实现
server/discover必实现:supportedVersions、capabilities、_meta.serverInfo、instructions,ttlMs=3600000、cacheScope=public
_meta 校验逐请求必填 protocolVersion + clientCapabilities,缺失 → -32602;版本不支持 → -32022(data.supported/data.requested)
resultType一切结果携带(complete / input_required)
ttlMs/cacheScopediscover、tools/list、resources/*(静态内容,public 共享缓存)
多轮交互(MRTR)gate 返回 ask 且客户端声明 elicitation 能力时 → resultType=input_required + inputRequests.gate_confirmation(elicitation/create,form)+ requestState;回执 accept/decline/cancel → allow/deny/不授权;requestState 为 HMAC-SHA256 防篡改 + 10 分钟过期 + 请求指纹(tool+command)比对,篡改/过期自动重发交互
resourcesresources/list + resources/read 暴露审批策略全文 phocinae://policy/gate-approval(text/markdown,含 L0/L1/fail-closed 判定链路、阈值、ask 处理义务)
已移除方法现代面下 initialize/ping/shutdown/logging/setLevel/subscriptions/listen → -32601(data 附 supportedVersions)
工具 schema 收紧maxLength(command/state 20000、cwd 4096、server 2048、列表单项 2000)、minItems/maxItems(1–100)、enum(decision/layer)、outputSchema 全量声明(classify/route/score additionalProperties:false);服务端同步执行同口径校验(越限 → -32602)
description 重写四工具均按「何时使用 / 何时不使用」结构重写
日志全部走 stderr;_meta 里 io.modelcontextprotocol/logLevel 门控(info 起,MCP 级日志协议字段)

兼容性:旧客户端 initialize 握手返回 2024-11-05 能力;无 _meta 的 tools/list/tools/call 按旧年代应答(不报错)——对旧客户端零破坏。

运行

▲ tools/call 真实判定:L0 定夺安全/危险命令,灰区才调模型

# stdio(默认)

python3 -m phocinae_mcp [--server http://127.0.0.1:8155] [--timeout 5] [--guard /path/to/guard.py] [--l1-enabled] [--model ]

Streamable HTTP

python3 -m phocinae_mcp --transport http [--host 127.0.0.1] [--port 8255]

python3 -m phocinae_mcp --version

--guard:复用 phocinae-guard 的 guard.py(L0 确定性表 + L1 编排),自动 探测同级 ../phocinae-guard/guard.py;找不到则 gate 降级为纯 HTTP noul+score 两问(engine: "http:noul+score")。导入 guard 时不写 __pycache__(只读复用)。

测试

python3 tests/test_mcp.py    # stdio 双代全流程冒烟 → tests/mcp_smoke.txt

python3 tests/test_http.py # Streamable HTTP 冒烟 → tests/http_smoke.txt

  • test_mcp.py:模拟 MCP 客户端,走 stdio 依次执行旧年代 initialize → notifications/initialized → ping → tools/list → tools/call 全工具矩阵(含失败分支)→ shutdown;现代年代 discover → tools/list → 全工具矩阵(gate allow/deny/ask、MRTR 接受/拒绝/取消/篡改、fail-closed、 schema 越限、-32602/-32022/-32601、resources)→ 通知。同时对 stdout 逐行审计(每行必须是 JSON-RPC 帧、日志零泄漏、无 traceback)。
  • test_http.py:HTTP 头校验矩阵(-32020/-32022/406/405/404/ 202)+ MRTR 全链路 + resources。
  • 两个测试共用 tests/mock_systemone.py(确定性 mock P0 服务,不跑模型)。

目录

phocinae_mcp/

├── server.py 主程序:双代分派、MRTR、CLI(stdio/http) ├── http_transport.py Streamable HTTP(新增) ├── protocol.py 2026-07-28 共享件(新增):版本/错误码/_meta 校验/ │ resultType/ttlMs/cacheScope/HMAC requestState/策略文本/日志门控 ├── tools.py 四工具 + 收紧后的 schema(description 重写) ├── backend.py 斑海豹 P0 客户端(原版不动) ├── guard_bridge.py guard.py 复用桥(+stdout 纯净性防护) └── init.py / main.py tests/ ├── test_mcp.py stdio 全流程冒烟 → mcp_smoke.txt ├── test_http.py HTTP 冒烟 → http_smoke.txt └── mock_systemone.py 确定性 mock P0 服务

安全声明(与斑海豹生态同口径)

▲ test_mcp.py 42/42 + test_http.py 18/18:帧强制 UTF-8,与 locale 无关(这是 0.1.x 上真实存在的缺陷)

  • gate 的 ask 结果要求集成方把命令与理由呈现给人工,未获明确批准 不得执行(现代面走 elicitation 交互,旧年代走结果文本);
  • 判定结果不构成任何法律责任承诺;fail-closed 是唯一默认;
  • 审批策略全文见资源 phocinae://policy/gate-approval(resources/read)。
PopNxに聞く