entyrix-mcp

@entyrix/mcp

Entyrix への Model Context Protocol アクセス — 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 でサインインするか（アカウントには Free キーが付属します）、API（POST /api/v1/signup、続いて POST /api/v1/signup/verify）を通じて API キーを取得してください。キーがなくてもサーバーは起動してツール一覧を表示しますが、最初のデータツール呼び出しは、これらの手順をエラー結果として返します。プラン：https://entyrix.com/pricing。

本番環境ではバージョンを固定してください（例：latest ではなく @entyrix/[email protected]）。ローカルの MCP サーバーはユーザーと同じ権限で実行され、バージョンを固定しない npx -y は、次に公開されたものをインストールするためです。

ツール

ツール	説明
search_companies	すべての市場で社名から企業を検索します
lookup_company	国を指定して登記 ID を完全一致検索します
company_brief	企業 1 社の簡潔な Markdown 概要 — 最も便利な単一の呼び出しです
get_company_details	拡張情報レイヤーを含む完全なレコードを取得します
get_financials	年ごとの財務諸表と推移を取得します（EUR セント）
get_company_network	役員や所有者の共有を通じてつながる企業を取得します
get_company_relations	役員、所有者、親会社、子会社、M&A イベントを取得します
advanced_search	国、NACE、規模、売上高、ステータスでページ分割された検索を行います
kyb_check	判定結果付きの KYB／AML 概要を一度の呼び出しで取得します
screen_companies	最大 25 社を一度に KYB スクリーニングします
check_compliance	公開コンプライアンス情報の概要を取得します（アカウント不要）
find_suppliers	公共部門の契約を検索します（B2G。サプライチェーンではありません）
list_rankings	事前計算済みのランキングを取得します

すべてのツールは読み取り専用で、出力スキーマを宣言し、不明な引数を拒否します。自然人データはサーバー側でライセンスに基づいて制御され、MCP 経由でも同じように適用されます。返される値は公開登記情報に由来します。エージェントでは信頼できないデータとして扱い、指示として扱わないでください。

設定

環境変数	デフォルト	説明
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

4 つを個別に実行するのではなく、check を実行してください。2026-08-12、lint + typecheck + test の合格後、format:check で CI が失敗したにもかかわらず、リリースが作成されました。スクリプト化せず記憶に頼っていたため、実行が抜けた唯一のステップでした。

リリース

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

バージョンは4つのファイルに記載されており、src/lib/__tests__/version.test.ts でそれらが一致することを検証しています。bump を使えば、リリースのたびにこのチェックに引っかかることはありません。プッシュは1回にしてください。プッシュごとにCIがフル実行されるため、4回に分けてリリースすると、4回分の実行に加えて、中間状態で失敗する実行が2回発生します。

npm publish はタグから OIDC の信頼されたパブリッシングを通じて実行されるため、トークンは不要です。npm のバージョンは変更できません。誤った内容を公開した場合、取り消すことはできず、新しいバージョンで置き換えるしかありません。そのため、公開前にタグと package.json のバージョンを照合しています。リリース処理は冪等です。再実行時には、すでに存在する npm のバージョンはスキップし、MCP Registry への登録前に npm から配信されるのを待ちます。

ライセンス

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