mcp nzbn
MCP服务器，将AI助手连接到 NZBN（新西兰企业编号）API。通过模型上下文协议搜索新西兰商业登记簿，查找公司详细信息、董事、文件等。
先决条件
- Python 3.10+
- NZBN API订阅密钥- 在此注册
安装
git clone https://github.com/Henzhc/mcp-nzbn.git
cd mcp-nzbn
pip install -e .配置
所有配置都是通过环境变量进行的。
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
NZBN_API_KEY | 是 | - | 您的NZBN API订阅密钥 |
NZBN_API_BASE_URL | 没有 | https://api.business.govt.nz/gateway/nzbn/v5 | 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"
mcp-nzbn添加到您的Claude桌面配置(claude_desktop_config.json):
{
"mcpServers": {
"nzbn": {
"command": "mcp-nzbn",
"env": {
"NZBN_API_KEY": "your-key"
}
}
}
}远程（流式HTTP）
作为团队的共享HTTP服务器运行。队友将他们的Claude客户端连接到URL。
export NZBN_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-nzbnMCP端点将在 http://:8000/mcp.
当 MCP_AUTH_TOKEN 如果已设置，则所有请求都必须包含标头：
Authorization: Bearer your-shared-secret没有有效令牌的请求将收到 401 Unauthorized 回应。
工具
| 工具 | 说明 |
|---|---|
search_entities | 按姓名、NZBN或旧号码搜索。支持对实体状态和类型进行筛选，并带有分页功能。 |
get_entity | 13位NZBN的完整实体详细信息——法定名称、交易名称、状态、地址、董事、股东。 |
get_entity_addresses | 注册地址和服务地址，可按地址类型过滤。 |
get_entity_roles | 实体的董事、股东和其他角色。 |
get_company_details | 公司办公室详细信息——年度申报表提交月份、章程等。 |
get_entity_filings | 按页码归档历史记录（年度申报表等）。 |
get_entity_history | 完整的更改历史记录——名称更改、状态更改、地址更改。 |
所有工具都是只读和幂等的。
项目结构
mcp-nzbn/
├── pyproject.toml # Package metadata and dependencies
├── nzbn_mcp.py # Convenience entry point (python nzbn_mcp.py)
└── src/mcp_nzbn/
├── __init__.py
└── server.py # MCP server, tools, and HTTP transport许可证
麻省理工学院