ptpge

PTPGE MCP Server

AI エージェントに、印刷のオープンな語彙であるPTPGE 仕様を公開する、読み取り専用のModel Context Protocolサーバーです。

語彙（永続的な URI を持つ用語、製品テンプレート、変数、スキーマ、レジスター）は、CC BY 4.0 のもとで https://api.ptpge.org/v1/ に公開されています。このサーバーはこれを読み込んでメモリに保持し、データセットのバージョンが変わると再読み込みして、少数の MCP ツールを通じてエージェントに提供します。用語の検索、用語の読み取り、製品エンベロープの読み取り、設定の検証、色表記の解決、設定フィンガープリント（ptpge-cfs/1）の計算と展開ができます。

稼働中、オープン、キー不要：https://mcp.ptpge.org/mcp（Streamable HTTP）。open.mcp.ptpge.org はエイリアスです。

アシスタントに追加する

• Claude（ウェブまたはデスクトップ）：Settings → Connectors → Add custom connector → https://mcp.ptpge.org/mcp
• ChatGPT：Settings → Connectors → Add (developer mode) → 同じ URL
• Claude Code：claude mcp add ptpge --transport http https://mcp.ptpge.org/mcp

その後、任意の言語で質問してください：「巻き折りとは何ですか？」または「A4 の三つ折りパンフレット、170 g のシルク紙、4/4 のフィンガープリントを作成して」。

ツール

ツール	機能
ptpge_search_terms	語彙を対象としたフリーテキスト検索。トークン化され、言語に依存しません。検索結果には URI、ラベル、レベル、グループ、kind（用語 · サプライヤー · ベンダー · スキーマ）、スコアが含まれます。特に指定しない限り、非推奨の用語は除外されます。
ptpge_get_term	用語の詳細情報：定義、関係（broader / narrower / related）、マッピング、プロパティ、表記。完全な URI または相対パスを指定できます。
ptpge_get_version	データセットのバージョン、用語数、ライセンス、スキーム URL、サーバーのバージョン。
ptpge_browse	ノードから階層をたどります。
ptpge_get_product_envelope	製品テンプレートについて、該当する変数、識別に必須の変数、許容される値を返します。
ptpge_validate_config	設定（語彙 URI に紐づく値）をエンベロープに照らして検証します。メンバーシップ、カーディナリティ、スコープ、数値範囲、変数間のルールを確認します。
ptpge_resolve_color_notation	4/4、4/1、1/0 … を語彙上の用語に基づく面ごとのインキ数に変換します。
ptpge_fingerprint	検証済みの設定を正規化し、その ptpge-cfs/1 フィンガープリント（仕様とオファー）を計算します。
ptpge_expand_fingerprint	ptpge.org/f/ のレジスターからフィンガープリントを設定に戻します。

応答はプレーンな JSON です。/playground ページでは、フリーテキストの注文からフィンガープリントを作成するまでのエージェントの処理を、すべてのツール呼び出しとともにトランスクリプトで確認できます。

エンドポイント

パス	用途
POST /mcp	Streamable HTTP による MCP（イベントストリームには GET、セッション終了には DELETE も使用します）
GET /health、/healthz	稼働状態とデータセットのバージョン
GET /playground	Playground
GET /sse	廃止済み — /mcp を示すポインターとともに 410 を返します

自分で実行する

python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python -m ptpge_mcp.server          # http://0.0.0.0:8000/mcp

MCP Inspector でテストするには、npx @modelcontextprotocol/inspector を実行し、トランスポートに Streamable HTTP、URL に http://localhost:8000/mcp を指定します。

pytest -q

設定

変数	デフォルト	用途
PTPGE_API_BASE	https://api.ptpge.org/v1	語彙の取得元
PTPGE_REFRESH_SECONDS	900	新しいデータセットがないか version.json を確認する間隔
PTPGE_LOG_LEVEL	INFO	Python のログレベル
PTPGE_MCP_AUTH_USERS	—	サーバーで使用する任意の Basic Auth。user:pass のペアをカンマ区切りで指定します。オープンサーバーにする場合は未設定のままにします。
PTPGE_MCP_HTPASSWD	—	上記の変数の代わりに使用する Apache htpasswd ファイルの任意のパス
PTPGE_MCP_TOKENS / _TOKENS_FILE	—	任意の受信者ごとのトークン（?t=）、同じ用途

mcp.ptpge.org の公開サーバーでは、認証関連の変数はどれも設定されていません。

構成

ptpge_mcp/
├── server.py           # tools, handlers, Streamable HTTP, Playground route
├── data.py             # fetch, cache, index, search
├── config.py           # environment-based runtime config
├── cfs_resolution.py   # canonicalisation + ptpge-cfs/1
├── fingerprint.py, fingermark.py   # hash and mark
├── completeness.py     # required variables / unspecified axes
├── colornotation.py    # 4/4-style notation → terms
├── semantic.py         # embedding search (term_embeddings.npz)
├── registerclient.py   # ptpge.org/f/ register client
├── playground.py, learningpage.py, missreport.py
└── _frame.py           # ptpge.org site frame (generated; do not edit)
tests/
passenger_wsgi.py       # cPanel/Passenger entry point for the hosted instance
.cpanel.yml             # deploy script for the hosted instance
CHANGELOG.md            # semver; one entry per release

バージョン管理

サーバーには Semver を使用し、データセットには独自の日付バージョン（ptpge_get_version）があります。フィンガープリントアルゴリズムは独立した契約 ptpge-cfs/1 であり、サーバーのリリースによって変更されません。

ライセンス

コード：Apache License 2.0。語彙とデータ：CC BY 4.0。非営利団体（設立準備中）である PTPGE が保有しています。ptpge.org/governance をご覧ください。

レジストリ

公式 MCP Registry に org.ptpge/mcp-server として登録されています（このリポジトリ内の server.json。mcp-publisher で公開され、ptpge.org の DNS レコードによって名前空間が検証されています）。