Zefix Search

Zefix MCP

⚠️ zefix.ch – スイス中央商業登記簿の非公式MCP サーバーです。
このプロジェクトは、zefix.chを開発・運営している連邦司法警察省（FDJP）連邦司法局（FOJ）とは提携しておらず、同機関からの承認も受けていません。

機能とユースケース

• AI アシスタントが、会社名またはUID（CHE-nnn.nnn.nnn）でスイスに設立された企業を検索できます。設立州、法人形態、所在地、旧社名などによる任意の絞り込みにも対応しています（ZefixのGUIにあるすべてのフィルターを再現しています）。
• AI アシスタントに、Zefixで利用できる企業の詳細情報（商号や識別番号、事業目的、住所、監査人、変更履歴、資本金、法定代理人の氏名、合併・買収）を提供し、さらなる自動化ワークフローの構築や、ビジネスに関する質問への回答に役立てられます。

MCPが回答できる質問の例

企業の検索

• 「Googleがスイスに法人を持っているか調べて、登記住所を表示してください。」
• 「Migrosとして知られている企業の正式な法人名とUIDは何ですか？」
• 「CHE-169.865.482を調べて、その企業についてわかることをすべて教えてください。」

絞り込みと企業の発見

• 「シャフハウゼン州に本社を置く、現在活動中のすべての信託会社を一覧表示してください。」
• 「チューリッヒ大都市圏のどこかに登記されている、塗装業を営む個人事業主を見つけてください。」
• 「スイスのフランス語圏にあるすべての銀行について、住所と法定代理人の一覧を作成してください。」

履歴と変更

• 「以前『SwissAir』という社名だった会社の新しい社名は何ですか？」
• 「Credit Suisseの社名と所有者の完全な変遷を教えてください。」
• 「UBS AGを引き継いだ、または合併した企業はありますか？」

デューデリジェンスと調査

• 「Zurich Insurance Groupの監査人として登録されているのは誰ですか？」
• 「Lindt & Sprüngliの代表者であるHans Müllerとの契約に署名するところです。彼にはその権限がありますか？」
• 「Bollingerが現在活動中の配管業者であることを確認し、創業からどのくらい経っているか、登記資本金はいくらか教えてください。」

要件

• MCPホストアプリケーション（Claude、LLM Studio、VSCode+GHCP/Cline、Cursor、Dive、LibreChat、DeepChat、Chainlitなど）
• ツール呼び出しに対応したLLM（GPT-4.1以降、Claude Sonnet/Opus、Gemini、Llama 3.1以降、Qwen3.5など）
• （任意）Node.js 24以降（開発時、またはnpxを使わずにローカルで実行する場合）

インストール

Claude Desktop拡張機能として（最も簡単）

1. Releasesページに移動し、最新のzefix.mcpbファイルをダウンロードします。
2. ダブルクリックすると、Claude Desktopが自動的に開きます。
3. インストールをクリックします。

利用可能なツールの一覧にzefixツールが表示されない場合は、Claude Desktopを再起動してください。

npx経由（その他すべてのMCPホストに推奨）

MCPホストの設定に追加します。

{
  "mcpServers": {
    "zefix": {
      "command": "npx",
      "args": ["-y", "zefix-mcp-unofficial"]
    }
  }
}

npxがパッケージを自動的にダウンロード、キャッシュ、実行します。ローカルへのインストールは不要です。

ソースから

git clone https://github.com/your-org/zefix-mcp-unofficial.git
cd zefix-mcp-unofficial
npm install
npm run build

続いて、このセクションをMCPホストアプリケーションの設定ファイルに追加します（構文はアプリケーションによって異なる場合があります。MCPホストアプリのドキュメントを確認してください）。

{
  "mcpServers": {
    "zefix": {
      "command": "node",
      "args": ["/absolute/path/to/zefix-mcp-unofficial/dist/index.js"]
    }
  }
}

ツールのリファレンス

get_companies

Zefix 登記簿を検索します。name_or_uid 以外のパラメーターはすべて省略可能です。

パラメーター	型	説明
name_or_uid	string	会社名または UID（CHE-nnn.nnn.nnn）。
language_key	string	応答言語：en、de、fr、it。デフォルト：en。
cantons	string[]	州コードで絞り込みます。例：["ZH", "BE"]。
locations	string[]	法的所在地の町名で絞り込みます。例：["Zurich", "Bern"]。
legalForms	string[]	法的形態で絞り込みます。例：["AG", "GmbH"]。
exactSearch	boolean	名前の先頭から検索します（デフォルト：true）。部分一致／ワイルドカード（*）検索を行うには、false に設定します。
phoneticSearch	boolean	音声学的／あいまい検索を有効にします。
includeDeleted	boolean	登記抹消済みの会社を含めます（デフォルト：false）。
includeFormerNames	boolean	以前の会社名も検索します（デフォルト：false）。

ヒント：

• UID がわかっている場合は、それを使用してください。最も正確で詳細な結果が返されます。
• exactSearch: true で結果が返されない場合は、exactSearch: false と phoneticSearch: true を組み合わせて再試行してください。
• 結果は YAML 形式で返されます。詳細度は見つかった会社の数によって異なります。
  • 1 件 → SOGC の公告履歴を含む完全な詳細情報
  • 2～10 件 → 詳細な概要。ただし、完全な履歴と法定代理人の一覧は含まれません
  • 11 件以上 → 会社名／UID／ステータスの一覧のみ
• 結果は最大 100 件です。
• サーバーは stdio（MCP 標準トランスポート）経由で通信します。直接実行してもターミナルには何も表示されません。
• MCP サーバーが Zefix REST API（https://www.zefix.ch/ZefixREST/api/v1/、公開されており認証不要）にクエリを送信する際は、透明性確保のため User-Agent: zefix-mcp-unofficial を送信します。この MCP をより大きなソリューションの一部として使用する場合は、変更してもよいでしょう。

---

開発とデバッグ

ビルド

npm run build
# Compiled output goes to dist/index.js

検査

MCP Inspector を使用して、ツールを対話的に呼び出し、応答を検査します。

npx @modelcontextprotocol/inspector node dist/index.js

初回実行時に @modelcontextprotocol/inspector のインストールを求められます。起動後、ターミナルに表示される URL（通常は http://localhost:5173）を開くと、Inspector UI にアクセスできます。

ワークフロー：

1. 左側のパネルで get_companies ツールを選択します。
2. パラメーターを入力します（例：name_or_uid: "Berg Digital"）。
3. 実行をクリックして、生の応答を確認します。

新しいリリースの公開

v* タグをプッシュすると、GitHub Actions のリリースワークフローが起動し、2 つのジョブを並行して実行します。

ジョブ	内容	公開先
npm への公開	npm run build、npm publish	npmjs.com
Claude プラグインの公開	npm run build、npx @anthropic-ai/mcpb pack を実行し、.mcpb アセットをアップロード	GitHub Releases

# 1. Bump version in BOTH files (npm will reject publishing over an existing version):
#    - package.json  → "version": "x.y.z"
#    - manifest.json → "version": "x.y.z"

# 2. Commit, tag, push — the tag MUST point to the version-bump commit:
git add package.json manifest.json
git commit -m "chore: release vX.Y.Z"
git tag vX.Y.Z
git push && git push --tags

⚠️ よくある間違い： package.json／manifest.json を編集する前にタグを作成してしまうこと。 CI はタグ付けされたコミットに含まれる package.json のバージョン文字列を公開します。タグ名自体は npm では無視されます。 早まってタグを付けてしまった場合は、タグを正しいコミットに移動してください。

git tag -d vX.Y.Z                   # ローカルタグを削除
git push origin :refs/tags/vX.Y.Z   # リモートタグを削除
# package.json と manifest.json を編集してから：
git add package.json manifest.json
git commit -m "chore: release vX.Y.Z"
git tag vX.Y.Z
git push && git push --tags

初回セットアップ（1 回のみ）：

• npm トークン： npmjs.com でアクセストークンを作成し、GitHub → Settings → Secrets and variables → Actions で NPM_TOKEN という名前のリポジトリシークレットとして追加します。トークンの有効期間は最長 90 日です。定期的に更新してください。
• GitHub リリース： 追加のセットアップは不要です。ワークフローは contents: write 権限を持つ組み込みの GITHUB_TOKEN を使用します。

---

ライセンス

• MIT。