European IP Data & Analytics — IPRATE

IPRATE 免费公共 MCP

适用于 IPRATE 匿名、只读 MCP 端点的开源适配器：

https://mcp.iprate.eu/mcp

生产端点是 worker/ 中的 Cloudflare Worker。它通过六个工具，提供对一个已完成的 IPRATE 静态发布版本的有限数据查询：

• find_ip_representatives
• get_ip_representative_profile
• get_ip_market_snapshot
• get_iprate_coverage
• search 和 fetch：供 ChatGPT 深度研究和企业知识库调用的一对检索工具（每次搜索最多返回十个文档引用，每次获取一个文档）

每个工具都声明了输出架构。src/ 中的 Python 包是前四个工具的自托管参考实现。

从助手连接

免费使用，无需账户或密钥。

Claude Code：

claude mcp add --transport http iprate https://mcp.iprate.eu/mcp

Claude Desktop 和 claude.ai：打开 Settings、Connectors，通过 https://mcp.iprate.eu/mcp 添加自定义连接器。

Cursor（~/.cursor/mcp.json）：

{ "mcpServers": { "iprate": { "url": "https://mcp.iprate.eu/mcp" } } }

ChatGPT：可为单个用户配置开发者模式下的自定义连接器，或由 Business 或 Enterprise 管理员添加工作区连接器。深度研究会使用 search 和 fetch 工具。

OpenAI Responses API：

{ "type": "mcp", "server_label": "iprate", "server_url": "https://mcp.iprate.eu/mcp", "require_approval": "never" }

付费 Data API 接入方式，使用在 IPRATE 账户中签发的密钥：

claude mcp add --transport http iprate-data https://mcp.iprate.eu/data-api/mcp --header "X-IPRATE-API-Key: YOUR_KEY"

价格和订购流程请见 https://iprate.eu/developers/data-api/。提供相同步骤的设置页面请见 https://iprate.eu/developers/mcp/。

同一个 Worker 还包含一个独立的付费 Data API 适配器，地址为：

https://mcp.iprate.eu/data-api/mcp

它提供八个 Data API v1 工具：get_coverage、resolve_entity、get_portfolio、get_trademark、search_trademarks、find_representative、get_firm_profile 和 create_watch。自定义 MCP 客户端使用签发的 API 凭据，通过 X-IPRATE-API-Key 发送请求。这是一种明确使用 API 密钥的适配器约定；它不接受或转发 OAuth bearer token。后端会对每次工具调用重新检查作用域、局、字段权限、配额、幂等性和计费。create_watch 标记为需要客户端确认的持久化写入操作。返回的注册簿文本会作为不可信数据引用。

配置 DATA_API_WORKER_SECRET 密钥绑定后（使用 wrangler secret put DATA_API_WORKER_SECRET，且值与 API 的 DATA_API_WORKER_SECRET 相同），每个转发请求都会在 X-IPRATE-Client-IP 中携带最终客户端的地址，并通过 X-IPRATE-Worker-Timestamp 和基于 <timestamp>.<address> 计算的 HMAC-SHA256 X-IPRATE-Worker-Signature 携带签名，这样 API 的预认证限流器就会按最终客户端而非 Worker 的出口地址分桶。如果未配置该密钥，则省略这些标头，API 会使用共享的转发限流桶。

它不包含数据库、ORM、SQL、数据库凭据、应用 API 回退机制，也不依赖 IPRATE 私有软件包。评分和统计数据均从已发布的 JSON 资源复制；MCP 服务不会重新计算这些数据。匿名调用会受到内存限流（HTTP 429，并附带 Retry-After；结果绝不会被静默截断）；GET /healthz 会报告是否有一个内部一致的发布版本可供服务。

静态输入

将 IPRATE_MCP_ASSET_ROOT 设置为已完成的、符合 /data/v1 结构的发布目录，其中包含 manifest.json、已发布的队列和全局资源，以及 mcp/v0.1/catalog.json。将 IPRATE_MCP_ASSET_BASE_URL 设置为源引用中使用的公开 URL。

目录仅根据静态档案资源生成：

iprate-free-mcp-build-catalog /path/to/data/v1

如果缺少必需索引、校验和不匹配、档案数量与发布清单不符，或档案资源无法读取，构建器就会失败。它绝不会导入或连接 IPRATE 的数据库、API、模型或流水线。

发布快照

在生产环境中，适配器不会读取实时且不断变化的导出目录。刷新器 （iprate-free-mcp-refresh-release）会监视实时的 manifest.json，并在出现新的 release_id 时，将清单中声明的所有资源复制到不可变的逐发布快照中（并根据清单验证校验和），在该 快照内构建目录，然后以原子方式重新指向 current 符号链接。在下一次发布激活前，服务会继续提供 上一个完整版本；如果发布在创建快照期间发生变化，则会放弃该快照，并在下一轮处理中重试。快照中不含 实体配置文件——配置文件数据仅通过派生目录引入——且目录绝不会写入公开提供的目录树中。

开发

python -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest
.venv/bin/ruff check .

针对兼容的静态发布运行适配器：

export IPRATE_MCP_ASSET_ROOT=/path/to/data/v1
export IPRATE_MCP_ASSET_BASE_URL=https://iprate.eu/data/v1
iprate-free-mcp

本地端点为 http://127.0.0.1:8000/mcp；存活状态检查为 GET /healthz。

生产容器

compose.yaml 会运行两个由同一镜像构建的加固服务：

• mcp — 服务端，以非特权、只读模式运行，仅挂载快照目录 （只读），并提供 IPRATE_MCP_ASSET_ROOT=/data/current。它会加入现有的 runtime_default 网络，以便通过 Cloudflare Tunnel 进行路由，且不发布任何主机端口。
• refresher — 快照构建器，使用 network_mode: none，以只读方式挂载实时 导出目录，并以读写方式挂载快照目录。

docker compose up -d --build

环境变量覆盖项：IPRATE_STATIC_ROOT（实时导出目录）、 IPRATE_MCP_RELEASES_ROOT（快照目录）、IPRATE_MCP_REFRESH_UID/GID （快照目录的所有者）、IPRATE_MCP_RATE_LIMIT_PER_MINUTE（默认值为 120）。 这两个服务都不会接收数据库或应用密钥。

文档：https://iprate.eu/developers/mcp/

Cloudflare Worker（生产环境）

Worker 提供 POST /mcp、GET /healthz，以及位于 GET /.well-known/openai-apps-challenge 的 OpenAI 域名验证令牌。它会从私有 R2 存储桶中读取一个不可变发布版本，该存储桶由发布构建器（iprate-free-mcp-build-worker-release）填充。

cd worker
npm ci
npx tsc --noEmit
npx vitest run

自 0.4.0 起的响应约定：响应通过 release_id 和 as_of 标明发布版本。不再包含发布事件记录、发布状态词或发布时效提示。hold_state 仍会报告 held 或 partial。

域名验证令牌是 Worker 变量。OpenAI 插件门户签发令牌后，在部署前将 OPENAI_APPS_CHALLENGE = "<token>" 添加到 worker/wrangler.toml 的 [vars] 下；wrangler deploy 会替换仅在控制面板中设置的变量。如果未设置该变量，此路径将返回 404。

ChatGPT 插件包

plugin/ 是上传到 OpenAI 插件门户的包（Agent Plugins 格式）：其中包含带有插件列表、审核用例和发布说明的 plugin.json（位于 extensions.com.openai 下）、指向生产端点的 mcp.json、select-european-ip-counsel 技能以及徽标。tests/test_plugin_package.py 会检查门户的字段限制，以及审核用例是否列出了 Worker 的实际工具。

从文件夹中的内容构建上传包，而不是上传文件夹本身：

python -c "import pathlib, zipfile; root = pathlib.Path('plugin'); z = zipfile.ZipFile('dist/iprate-plugin.zip', 'w', zipfile.ZIP_DEFLATED); [z.write(p, p.relative_to(root).as_posix()) for p in sorted(root.rglob('*')) if p.is_file()]; z.close()"

提交前添加视频演示 URL（review.demo_recording_url）以及任何国家/地区允许列表 （publication.countries）。无需提供审核人员凭据：该服务无需身份验证。

许可证

适配器代码采用 Apache-2.0 许可证。IPRATE 数据和网站内容适用单独的条款和许可证；本代码许可证不授予对这些内容或 IPRATE 商标的权利。