Zefix Search

Zefix MCP

⚠️ 非官方 MCP 服务，适用于 zefix.ch – 瑞士中央企业名称索引。
本项目与开发和维护 zefix.ch 的联邦司法和警察部（FDJP）—联邦司法办公室（FOJ）无关，也未获得其认可。

功能与用例

• 允许你的 AI 助手按名称或 UID（CHE-nnn.nnn.nnn）搜索在瑞士注册成立的公司，并可按注册州、法律形式、地点、曾用名等进行筛选（模拟 Zefix 图形界面中的所有筛选条件）。
• 为你的 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 等）
• 支持工具调用的大模型（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 用作更大型解决方案的一部分，你可能需要更改 uf。

---

开发和调试

构建

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 界面。

工作流：

1. 在左侧面板中选择 get_companies 工具。
2. 填写参数（例如 name_or_uid: "Berg Digital"）。
3. 点击 运行 并检查原始响应。

发布新版本

推送 v* 标签会触发 GitHub Actions 发布工作流，该工作流会并行运行两个任务：

任务	执行内容	发布位置
发布到 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

首次设置（一次性操作）：

• **npm token：**在 npmjs.com 创建 Access token → 在 GitHub → Settings → Secrets and variables → Actions 中将其添加为名为 NPM_TOKEN 的 Repository secret；token 有效期最长为 90 天——请定期更新。
• **GitHub 发布：**无需额外设置——工作流使用内置的 GITHUB_TOKEN，并具有 contents: write 权限

---

许可证

• MIT。