AI导哈

商业注册查询服务

连接AI助手与新西兰商业注册API的服务，支持查询新西兰商业编号、公司详情、董事、股东等信息。

  • by montarne
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Henzhc/mcp-nzbn

使用说明

mcp mbie

MCP服务器将AI助手连接到MBIE商业注册API—— NZBN（新西兰企业编号）API 和那个 公司实体角色搜索API。通过模型上下文协议搜索新西兰商业登记簿，查找公司详细信息、董事、股东、文件等。

先决条件

  • Python 3.10+
  • NZBN API订阅密钥- 在这里注册
  • 公司实体角色搜索API订阅密钥（用于 search_entity_roles)

安装

git clone https://github.com/Henzhc/mcp-mbie.git
cd mcp-mbie
pip install -e .

配置

所有配置都是通过环境变量进行的。

变量 必填 默认 描述
NZBN_API_KEY 是 - 您的NZBN API订阅密钥
COMPANIES_ROLE_API_KEY 是 - 您的公司实体角色搜索API订阅密钥
NZBN_API_BASE_URL 没有 https://api.business.govt.nz/gateway/nzbn/v5 NZBN API基础URL
COMPANIES_ROLE_API_BASE_URL 没有 https://api.business.govt.nz/gateway/companies-office/companies-register/entity-roles/v3 实体角色API基本URL
NZBN_TIMEOUT 没有 30 HTTP请求超时（秒）
MCP_TRANSPORT 没有 stdio 运输： stdio 或 streamable-http
MCP_HOST 没有 0.0.0.0 绑定地址（HTTP模式）
MCP_PORT 没有 8000 侦听端口（HTTP模式）
MCP_AUTH_TOKEN 没有 -- HTTP身份验证的承载令牌（可选）

用法

本地（stdio）

最适合单用户设置。Claude直接生成服务器进程。

export NZBN_API_KEY="your-key"
export COMPANIES_ROLE_API_KEY="your-key"
mcp-mbie

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "mbie": {
      "command": "mcp-mbie",
      "env": {
        "NZBN_API_KEY": "your-key",
        "COMPANIES_ROLE_API_KEY": "your-key"
      }
    }
  }
}

远程（流式HTTP）

作为团队的共享HTTP服务器运行。队友将他们的Claude客户端连接到URL。

export NZBN_API_KEY="your-key"
export COMPANIES_ROLE_API_KEY="your-key"
export MCP_TRANSPORT=streamable-http
export MCP_AUTH_TOKEN="your-shared-secret"  # optional, enables bearer auth
export MCP_PORT=8000
mcp-mbie

MCP端点将在 http://<host>:8000/mcp.

当 MCP_AUTH_TOKEN 如果已设置，则所有请求都必须包含标头：

Authorization: Bearer your-shared-secret

没有有效令牌的请求将收到 401 Unauthorized 回应。

工具

新西兰氮化硼API

工具 说明
search_entities 按姓名、NZBN或旧号码搜索。实体状态、类型和行业代码的过滤器，带分页。
get_entity 13位NZBN的完整实体记录——法定名称、商号、状态、地址、角色、商品及服务税编号、行业分类。
get_entity_addresses 一种类型的地址（注册地址、邮局地址、服务地址、办公室地址、交货地址、发票地址）。
get_entity_roles 已知实体的董事、股东和其他角色。
get_company_details 新西兰公司办公室详细信息——年度申报表提交月份、章程、NZSX代码。
get_entity_non_company_details 非公司实体的注册详细信息——有限合伙企业、慈善信托、法人团体。
get_entity_filings 完整的归档历史（年度申报表、董事变更等），并附有文件链接。
get_entity_phone_numbers 实体的电话号码。
get_entity_email_addresses 实体的电子邮件地址。
get_entity_websites 实体的网站。
get_entity_gst_numbers 为实体注册的商品及服务税编号。
get_entity_industry_classifications 实体的行业分类（BIC代码）。
get_entity_trading_areas 为实体申报的地理交易区域。
get_entity_history 完整的更改历史记录——名称更改、状态更改、地址更改。

公司实体角色搜索API

工具 说明
search_entity_roles 按个人或组织名称搜索董事和股东——查找一个人在其中担任角色的所有公司

所有工具都是只读和幂等的。

项目结构

mcp-mbie/
├── pyproject.toml              # Package metadata and dependencies
├── app.py                      # ASGI entry point for Azure App Service
└── src/mcp_mbie/
    ├── __init__.py
    └── server.py               # MCP server, tools, and HTTP transport

许可证

麻省理工学院

相关 MCP