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设置。
许可证
麻省理工学院