Hptsu

hpt.su MCP サーバー

ロシアおよびEAEUの車両適合文書レジストリ hpt.su 用のModel Context Protocolサーバー — 型式認証（ОТТС / СБКТС / ОТШ）、適合証明書（ТР ТС / ТР ЕАЭС）、適合宣言、型式認証通知（СУТ）、および単一車両評価報告書に対応します。

これは何ですか

hptsu-mcpを使うと、MCP互換のあらゆるAIアシスタント（Claude Desktop、Cursor、Cline、Continue、Goose、Cherry Studio、5ire、LM Studio、ChatGPT Desktopなど）からhpt.suレジストリを直接検索できます。チャット画面とウェブサイトの間で番号をコピー＆ペーストする必要はありません。

hpt.suは、ロシア連邦およびEAEU関税同盟における、次の文書を収録した最大規模の統合データベースです。

• 適合証明書 — TR CU / TR EAEU技術規則に基づいて発行された適合証明書です。hpt.su/documents/cert/で閲覧できます。
• 適合宣言 — 適合宣言です。hpt.su/documents/decl/で閲覧できます。
• ОТТС — TR CU 018/2011に基づく車両型式認証（Одобрение типа транспортного средства）です。自動車、トラック、バス、トレーラー、オートバイが対象です。hpt.su/documents/otts/で閲覧できます。
• СБКТС — 車両構造安全証明書（Свидетельство о безопасности конструкции транспортного средства）です。hpt.su/documents/sbkts/で閲覧できます。
• ОТШ — シャーシ型式認証（Одобрение типа шасси）です。hpt.su/documents/otch/で閲覧できます。
• СУТ — 型式認証通知（Сообщение об утверждении типа транспортного средства）です。hpt.su/documents/sout/で閲覧できます。
• ЗОЕТС / ЗОТШ / ЗОТТС — 認定試験機関が発行する、単一車両／シャーシ／車両の評価報告書です。hpt.su/documents/zoets/、zotch/、zotts/で閲覧できます。

LLMエージェントは、このサーバーを通じて次のような依頼に対応できます。

• 「2024年式KAMAZ-43118トラックの型式認証を見つけてください。」
• 「EAC適合宣言 ЕАЭС N RU Д-RU.HA67.B.12345/24 のステータスを教えてください。」
• 「スキーム1сに基づき、申請者「Group GAZ」に発行された最近の適合証明書を一覧表示してください。」
• 「VINから特定したシャーシ番号XYZ123…に対して、СБКТСは発行されていますか？」
• 「メーカーXに発行された型式認証通知（СУТ）を取得してください。」

クイックスタート

1. インストール

uv tool install hptsu-mcp
# or
pipx install hptsu-mcp
# or with plain pip
pip install hptsu-mcp

2. APIキーを取得する

MCPには2つのプランがあります。

プラン	リクエスト制限	料金	取得先
無料MCP	1日50リクエスト。サイト購読者は、購読中のレジストリで1日500件（それ以外では1日50件）	無料、要登録	hpt.su/user/mcp/
有料APIプラン（Lite/Standard/Pro）	1日500～10,000リクエスト、全文検索＋直接ダウンロード	料金を参照	hpt.su/pricing/#api-tiers

無料プランは、デモや個人利用には十分です。有料プランにアップグレードすると、fulltext_search、download_document_file、VINアグリゲーター、および1日の上限引き上げが利用可能になります。

1. hpt.su/accounts/signup/でアカウントを作成します。
2. hpt.su/user/mcp/で「Get free MCP key」をクリックします。
3. （任意）hpt.su/pricing/でアップグレードします。

APIドキュメント（Swagger UI）：https://hpt.su/api/v1/docs/ · OpenAPIスキーマ：https://hpt.su/api/v1/schema/

3. MCPクライアントに接続する

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "hpt-su": {
      "command": "hptsu-mcp",
      "env": {
        "HPTSU_API_KEY": "your-key-here"
      }
    }
  }
}

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "hpt-su": {
      "command": "hptsu-mcp",
      "env": { "HPTSU_API_KEY": "your-key-here" }
    }
  }
}

Cline / Continue / Goose / etc.

stdio トランスポートをサポートする MCP クライアントであれば、どれも同じ方法で動作します。hptsu-mcp 実行ファイルを指定し、環境変数に HPTSU_API_KEY を渡してください。

HTTP / SSE トランスポート

ホスト型 MCP ゲートウェイでは、HPTSU_TRANSPORT=streamable-http（または sse）を設定し、ネットワーク経由でサーバーを呼び出します。

OAuth（ホスト型モード）

https://mcp.hpt.su/mcp のホスト型インスタンスは、OAuth 2.0 の保護されたリソース（RFC 9728）として機能します。https://hpt.su を認可サーバーとして指定する /.well-known/oauth-protected-resource/mcp を公開し、未認証の /mcp リクエストには 401 WWW-Authenticate: Bearer resource_metadata="..." でチャレンジします。これにより、OAuth ディスカバリーに対応したクライアントは、手動で発行した API キーなしで接続できます。

ホスト型エンドポイントでは、次の 2 種類の認証情報をどちらも使用できます。

• X-API-Key: <public_id>:<secret> — hpt.su/user/mcp/ で発行する静的キーです。カスタムヘッダーを設定できるあらゆるクライアント（Cursor、Cline、Continue、ローカルスクリプトなど）で使用できます。
• OAuth 2.0 Bearer — 標準的な MCP OAuth フロー（ディスカバリー → 動的クライアント登録 → 認可コード + PKCE）で取得します。MCP の OAuth ディスカバリーを実装している次のクライアントが対応しています。
  • ChatGPT（Developer Mode / Connectors）
  • Claude.ai / claude.com（カスタムコネクター）
  • VS Code（MCP 拡張機能ホスト）
  • Cursor（cursor:// ディープリンクコールバック経由）
  • 127.0.0.1 / localhost にリダイレクトするローカル／ループバッククライアント（一般的なデスクトップアプリの OAuth コールバック方式）

異なる MCP リソース（RFC 8707）に紐付いた Bearer トークンや、有効期限切れ／失効した Bearer トークンは、トランスポートで 401 として拒否されます。クライアントはこれをデータ応答として扱わず、トークンを更新するか、OAuth フローを再実行する必要があります。

ツール

検索と取得

ツール	機能	ティア
search_documents	文書番号でレジストリを横断検索します。レジストリの種類が不明な場合に使用します。	無料
get_document	検索結果から取得した slug と kind を指定して、1 件の文書の完全なレコードを取得します。	無料
search_certificates	適合証明書（ТР ТС / ТР ЕАЭС）を検索します。番号、申請者、ステータス、スキーム、規則、製品で検索できます。	無料
search_declarations	適合宣言（ТР ТС / ТР ЕАЭС）を検索します。	無料
search_otts	ОТТС — 車両型式認可（ТР ТС 018/2011）を検索します。	無料
search_otch	ОТШ — シャシー型式認可を検索します。	無料
search_zotts	ЗОТТС — 車両適合性評価の結論を検索します。	無料
search_zotch	ЗОТШ — シャシー適合性評価の結論を検索します。	無料
search_sbkts	СБКТС — 車両の設計安全証明書を検索します。	無料
search_zoets	ЗОЕТС — 個別車両の技術鑑定に関する結論を検索します。	無料
search_sout	СУТ — 型式認可の通知を検索します（データセットが小さく、基本項目のみ）。	無料
search_by_vin	ОТТС / ОТШ / ЗОТТС / ЗОТШ / СБКТС / ЗОЕТС を横断して、VIN を集約検索します。	無料
fulltext_search	ОТТС / ОТШ / ЗОТТС / ЗОТШ の PDF 本文を全文検索します。	有料
list_document_files	文書に添付されたファイルを一覧表示します（ダウンロード用の file_uid を返します）。	無料
download_document_file	文書ファイルへのリンクを取得します。ページ URL は常に返されます。署名付きの直接ダウンロード URL の取得には、それを含むプランが必要です。	無料 / 有料

参照辞書

ツール	機能
list_brands	車両ブランド名を解決します。
list_vehicle_models	ブランド内の車両モデル名を解決します。
list_test_labs	認定試験機関です。
list_certification_bodies	認定認証機関です。
list_tnved_codes	TN VED EAEU 分類（証明書／申告書に関するコンテキストのみ）です。
list_registry_kinds	API が公開するレジストリの種類を列挙します。

参照フィルターには内部 ID ではなく名前を指定してください。 検索ツールが人間に読みやすい値を自動で解決するため、issuer="НАМИ"、brand="KAMAZ"、 eco_class="5"、wheel_formula="4x2"、axis_count="2" を渡すと、サーバーが参照 ID を検索します（issuer／brand には数値 ID も直接指定できます）。 名前が曖昧な場合は、選択可能な候補が返されます。

設定

変数	デフォルト	説明
HPTSU_API_KEY	必須	hpt.su の管理画面で取得する Bearer キーです。
HPTSU_BASE_URL	https://hpt.su/api/v1	ステージング環境／オンプレミス環境での上書きに使用します。
HPTSU_TRANSPORT	stdio	stdio · streamable-http · sse。
HPTSU_TIMEOUT	30.0	リクエストごとの HTTP タイムアウト（秒）です。
HPTSU_USER_AGENT	hptsu-mcp/0.1	User-Agent ヘッダーです。
HPTSU_LOG_LEVEL	INFO	標準の logging レベルです。

SEO 説明（カタログ掲載用）

hpt.su MCP サーバー — AI アシスタントから hpt.su のロシアおよび EAEU の車両適合文書データベースを直接検索できます。型式認証（ОТТС、ОТШ）、設計安全証明書（СБКТС）、TR CU／TR EAEU 技術規則に基づく適合証明書および適合宣言書、型式認証通知（СУТ）を網羅しています。参照レジストリ：https://hpt.su。API ドキュメント：https://hpt.su/api/v1/docs/。読み取り専用、Bearer キー認証、MIT ライセンスです。

ロシア語版：

hpt.su の MCP サーバー — 自動車輸送向けのロシアおよび EAEU の適合文書に関する大規模データベースを検索できます。対象は ОТТС、СБКТС、ОТШ、СУТ（型式認証通知）、適合証明書および適合宣言書（ТР ТС／ТР ЕАЭС）です。情報源：https://hpt.su。REST API：https://hpt.su/api/v1/docs/。読み取り専用、Bearer 認証、MIT ライセンスです。

キーワード

mcp · model-context-protocol · hpt.su · vehicle certification · type approval · ОТТС · СБКТС · EAEU · TR CU 018 · conformity certificate · declaration of conformity · сертификат соответствия · декларация о соответствии · СУТ · Russian compliance database · AI agent · Claude · Cursor · Cline

開発

git clone https://github.com/hpt-su/hptsu-mcp
cd hptsu-mcp
uv sync --all-groups
uv run pytest
uv run hptsu-mcp           # launch via stdio

ライセンス

MIT — LICENSE を参照してください。

リンク

• 参照レジストリ：https://hpt.su
• MCP ランディングページ：https://hpt.su/mcp/
• MCP キー管理画面：https://hpt.su/user/mcp/
• API ドキュメント：https://hpt.su/api/v1/docs/
• OpenAPI スキーマ：https://hpt.su/api/v1/schema/
• 公開料金：https://hpt.su/pricing/
• Issue トラッカー：https://github.com/hpt-su/hptsu-mcp/issues
• お問い合わせ：[email protected]
• Model Context Protocol：https://modelcontextprotocol.io

mcp-name: su.hpt/hptsu-mcp