entyrix-mcp

@entyrix/mcp

通过 Model Context Protocol 访问 Entyrix——覆盖 23 个已上线市场的欧洲企业注册信息（KYB）数据（FR、GB、RO、SK、UA、GR、CZ、BE、NO、IE、FI、CH、PL、AT、CY、LT、LV、EE、SI、ES、IT、NL、HR）。

使用远程服务（推荐）

Entyrix 运行着一个远程 MCP 服务（Streamable HTTP，协议版本 2025-03-26 … 2026-07-28）：

https://entyrix.com/mcp/v1

将其作为远程／自定义连接器添加到 Claude、ChatGPT、Cursor 或 VS Code 中。首次调用工具时，客户端会打开 Entyrix 登录页面（通过 PKCE 的 OAuth 2.1）——无需在配置文件中填写密钥。通过命令行：

claude mcp add --transport http entyrix https://entyrix.com/mcp/v1

完整说明：https://entyrix.com/mcp。

此软件包：stdio 桥接器

适用于只支持 stdio 的客户端。从 0.2.0 版本起，该软件包不再自行实现工具——它会将每条 JSON-RPC 消息转发到上述远程服务，并使用环境变量中的 API 密钥，因此始终会提供当前目录中的全部工具。它的运行时依赖为 零。

ENTYRIX_API_KEY=sk_... npx -y @entyrix/mcp

{
  "mcpServers": {
    "entyrix": {
      "command": "npx",
      "args": ["-y", "@entyrix/mcp"],
      "env": { "ENTYRIX_API_KEY": "sk_..." }
    }
  }
}

登录 https://entyrix.com/login 获取 API 密钥（账户附带一个 Free 密钥），也可以通过 API 获取（先调用 POST /api/v1/signup，再调用 POST /api/v1/signup/verify）。没有密钥时，服务仍会启动并列出其工具；首次调用数据工具时，会将这些步骤作为错误结果返回。套餐信息：https://entyrix.com/pricing。

生产环境中请固定版本（例如 @entyrix/[email protected]，而非 latest）：本地 MCP 服务以你的权限运行，而不固定版本的 npx -y 会安装后续发布的任何版本。

工具

工具	功能
search_companies	在所有市场中按名称查找企业
lookup_company	按国家限定，精确查询注册 ID
company_brief	生成单家企业的精简 Markdown 简报——最实用的单次调用
get_company_details	获取包含增强数据层的完整记录
get_financials	按年份获取财务报表及趋势（欧分）
get_company_network	查找通过共同高管和所有者关联的企业
get_company_relations	查询高管、所有者、母公司、子公司及并购事件
advanced_search	按国家、NACE、规模、营业额和状态分页筛选
kyb_check	通过单次调用获取 KYB/AML 摘要及判定结果
screen_companies	一次对最多 25 家企业进行 KYB 筛查
check_compliance	公开合规快照（无需账户）
find_suppliers	公共部门合同（B2G，不是供应链）
list_rankings	预先计算的排行榜

所有工具均为只读，声明输出架构，并拒绝未知参数。自然人数据由服务端进行许可限制，通过 MCP 访问时也同样适用。返回值来自公开注册信息——在 Agent 中应将其视为不可信数据，绝不能当作指令。

配置

环境变量	默认值	描述
ENTYRIX_API_KEY	(无)	Entyrix 账户中的 Bearer API 密钥
ENTYRIX_BASE_URL	https://entyrix.com	用于覆盖为预发布环境
ENTYRIX_TIMEOUT_MS	60000	每个请求的 HTTP 超时时间

开发

git clone <repo>
cd entyrix-mcp
npm install
npm run build
npm test

本地 stdio 健全性检查：

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js

npm run test:contract 会针对线上服务运行桥接器（无需密钥）。

质量门禁

npm run check   # format:check + lint + typecheck + test — the same four CI runs

请运行 check，不要手动逐一运行这四项。2026-08-12 的一次发布是在 lint + typecheck + test 通过后切出的，但 CI 因 format:check 失败——这一步 被漏掉了，因为当时只是靠记忆执行，而没有将其写入脚本。

发布

npm run bump 0.2.2          # writes all four manifests, refuses on drift
npm run check
git commit -am "chore(release): 0.2.2"
git tag v0.2.2
git push && git push --tags   # one push, then the tag

版本号保存在四个文件中，src/lib/__tests__/version.test.ts 会断言它们一致；bump 可避免每次发布时都触发这项检查。只推送一次即可——每次推送都会运行完整的 CI，而分四次推送来完成一次发布会消耗四次 CI 运行（中间状态还会有两次失败）。

npm publish 会通过 OIDC 可信发布从标签运行，因此无需使用令牌。npm 版本不可变：错误的发布无法撤回，只能由后续版本取代——因此，在发布任何内容之前，会先检查标签与 package.json 是否一致。发布过程是幂等的：重新运行时会跳过已存在的 npm 版本，并等待 npm 提供该版本后再向 MCP Registry 注册。

许可证

MIT — 参见 LICENSE。