AI导哈

瑞士公司注册查询服务

通过Claude直接查询瑞士官方公司注册信息，包括公司详情、法律形式、审计公司、公司历史及官方公报发布内容。

  • by johnphilipp
  • Python
  • 混合部署
  • 更新于
在 GitHub 查看 johnphilipp/mcp-server-zefix

使用说明

mcp服务器zefix

直接从克劳德那里查找任何瑞士公司。

一 主控程序 将Claude连接到的服务器 Zefix，瑞士官方公司注册（Handelsregister）。Zefix由联邦司法局运营，提供来自所有26个州商业登记处的权威数据，包括公司详细信息、法律表格、审计公司、公司历史和官方公报出版物。

你可以问什么

  • “在Zefix上搜索诺华”
  • “查找巴塞尔的所有基金会”
  • “谁审计诺华公司？”
  • “诺华收购了哪些公司？”
  • “给我看看KIBAG Bauleistungen AG的所有分支机构”
  • “获取CHE-467.005.033的公司结构”
  • “向我展示Huber Baustoffe AG的公司历史”
  • “cohaga AG最近进行了哪些资本变动？”
  • “查找苏黎世的所有GmbH”
  • “列出所有瑞士德语法律表格”

快速开始

托管（无需安装）

直接连接--没有API密钥，没有凭据，只有URL。

第ai条：

设置>自定义>连接器>添加自定义连接器：

  • 网址： https://mcp-server-zefix.contextfor.ai/mcp

克劳德代码：

claude mcp add --transport http zefix https://mcp-server-zefix.contextfor.ai/mcp

本地

claude mcp add zefix -- uvx mcp-server-zefix

或者添加到您的Claude Desktop配置中(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "zefix": {
      "command": "uvx",
      "args": ["mcp-server-zefix"]
    }
  }
}

工具

工具 说明
search_companies 按名称搜索（支持通配符），按州和法律形式过滤
get_company_by_uid 完整的公司简介：地址、目的、审计公司、收购历史、分支机构、以前的名字
get_company_by_chid 与上述相同，使用CH-ID标识符
get_company_structure 将总部和所有分支机构放在一张有完整地址的表格中。适用于任何分支UID。
get_company_publications SHAB时间表：董事会变更、资本变更、合并、地址变更等
list_legal_forms 所有瑞士法律表格（AG、GmbH、Stiftung等）都带有用于过滤的ID

所有工具都接受 language 参数（de、fr、it、en）。输出标签使用所选语言的官方Zefix术语。

你得到了什么

公司查询返回：

  • 标识符 --姓名、UID、CH-ID、状态、法律形式
  • 位置 --注册办事处，完整地址
  • 目的 --公司声明的经营目的
  • 审计事务所 --审核员的姓名和UID
  • 企业历史 --被吸收的公司、收购、以前的名字
  • 公司架构 --以表格形式显示总部和所有分支机构的地址
  • 分支机构 --所有已注册的分支机构
  • 民政事务局局长刊物 --瑞士官方公报中具有法律意义的事件时间表（董事会变更、资本变更、合并、目的变更）
  • 州注册链接 --与董事会成员和签署人直接链接到完整摘录

配置

使用公共Zefix API进行零配置。对于官方认证的API，设置以下环境变量：

变量 默认值 描述
ZEFIX_BASE_URL https://www.zefix.ch/ZefixREST/api/v1 API基本URL
ZEFIX_USERNAME （无） ZefixPublicREST API的用户名
ZEFIX_PASSWORD （无） ZefixPublicREST API的密码

若要使用官方API，请从 zefix@bj.admin.ch那么：

{
  "mcpServers": {
    "zefix": {
      "command": "uvx",
      "args": ["mcp-server-zefix"],
      "env": {
        "ZEFIX_BASE_URL": "https://www.zefix.admin.ch/ZefixPublicREST/api/v1",
        "ZEFIX_USERNAME": "your-username",
        "ZEFIX_PASSWORD": "your-password"
      }
    }
  }
}

发展

git clone https://github.com/johnphilipp/mcp-server-zefix.git
cd mcp-server-zefix
uv sync --all-extras

uv run ruff check .           # lint
uv run pytest tests/ -v       # test (68 tests, all use fakes, no network)
npx @modelcontextprotocol/inspector uv --directory . run mcp-server-zefix  # interactive

建筑

跟随 Python架构模式 （珀西瓦尔和格雷戈里）：

  • 领域模型 (models.py)--冻结的数据类(Company, LegalForm, ShabPublication)，域异常，无基础结构导入
  • 端口+适配器 (zefix_client.py) -- AbstractZefixClient 协议； HttpZefixClient 将HTTP转换为域对象，将httpx异常转换为域异常
  • 服务层 (server.py) -- handle_* 函数接受抽象客户端，从不导入httpx
  • 本地化 (i18n.py)--使用Zefix官方术语的集中标签翻译（de/fr/it/en）
  • 假冒伪劣 --测试使用 FakeZefixClient，一种在内存中工作的实现；测试文件从不导入httpx

自足执行

服务器支持通过Streamable HTTP传输进行远程部署。看 Dockerfile, docker-compose.prod.yml，以及 Caddyfile 对于带有自动HTTPS的Docker+Caddy设置。

许可证

麻省理工学院

相关 MCP