Hptsu

hpt.su MCP 服务

面向 hpt.su 登记库的 Model Context Protocol 服务，收录俄罗斯和 EAEU 车辆合规文件——型式批准（ОТТС / СБКТС / ОТШ）、合格证书（ТР ТС / ТР ЕАЭС）、符合性声明、型式批准通知（СУТ）以及单车评估报告。

项目简介

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 Agent 可通过此服务完成的任务：

• “查找 2024 款 KAMAZ-43118 卡车的型式批准。”
• “ЕАЭС N RU Д-RU.HA67.B.12345/24 这份 EAC 符合性声明目前是什么状态？”
• “列出近期依据 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 提供两个级别：

级别	限流	价格	获取方式
免费 MCP	每天 50 次请求；网站订阅用户在已订阅的登记库中每天可请求 500 次（其他登记库每天 +50 次）	免费，需注册	hpt.su/user/mcp/
付费 API 级别（Lite/Standard/Pro）	每天 500–10 000 次请求，支持全文搜索和直接下载	查看价格	hpt.su/pricing/#api-tiers

免费级别足以满足演示和个人使用。升级后即可使用 fulltext_search、download_document_file、VIN 聚合器以及更高的每日请求上限。

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 等

任何支持 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）：它会发布 /.well-known/oauth-protected-resource/mcp，指向以 https://hpt.su 为 授权服务端，并对未经身份验证、访问 /mcp 的请求返回质询 401 WWW-Authenticate: Bearer resource_metadata="..."。这使支持 OAuth 发现的 客户端无需手动签发 API 密钥即可连接。

两种凭据形式都可用于托管端点：

• 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 令牌，或已过期/已撤销的令牌， 会被拒绝并返回传输层 401——客户端应刷新令牌或重新运行 OAuth 流程， 而不是将其视为数据响应。

工具

搜索与检索

工具	功能	层级
search_documents	按文档编号跨注册库搜索——注册类别未知时使用。	免费
get_document	根据 slug + kind（均取自搜索结果）获取一份文档的完整记录。	免费
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 许可证。

俄语版本：

MCP-сервер hpt.su — поиск по крупнейшей базе российских и ЕАЭС документов соответствия для автотранспорта: ОТТС, СБКТС, ОТШ, СУТ (сообщения об утверждении типа), сертификаты соответствия и декларации (ТР ТС / ТР ЕАЭС). Источник: 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/
• 问题跟踪：https://github.com/hpt-su/hptsu-mcp/issues
• 联系方式：[email protected]
• Model Context Protocol：https://modelcontextprotocol.io

mcp-name: su.hpt/hptsu-mcp