AI导哈

商业注册查询服务

提供对捷克ARES商业注册API的访问，支持公司名称、IČO号码等多种搜索条件，适用于商业调查和数据分析。

  • by vzeman
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 vzeman/ares-mcp-server

使用说明

ARES MCP服务器

模型上下文协议（MCP）服务器，提供访问捷克ARES（经济实体行政登记处）API - 捷克共和国的官方商业登记处。

自定义MCP服务器开发

我们为客户开发定制的MCP服务器。如果您的系统需要与此MCP服务器类似的MCP服务器，请联系我们(https://www.flowhunt.io/contact/). 详细了解我们如何为客户开发MCP服务器：https://www.flowhunt.io/services/mcp-server-development/

演示

请参阅Claude Desktop中的ARES MCP服务器：

演示显示：

  • 🔍 按名称搜索公司（例如“AiMingle”）
  • 📋 通过IČO获取详细的公司信息
  • ✅ 验证IČO编号
  • 🏢 在特定注册表中搜索
  • 📊 使用高级过滤器（法律形式、CZ-NACE代码等）

快速开始

  1. 安装服务器：

    git clone https://github.com/yourusername/ares-mcp-server.git
cd ares-mcp-server
pip install -e .

  2. 添加到Claude桌面配置：

    {
  "mcpServers": {
    "ares": {
      "command": "python3",
      "args": ["-m", "ares_mcp_server.server"],
      "cwd": "/path/to/ares-mcp-server"
    }
  }
}

  3. 重启克劳德桌面，开始搜索捷克公司！

特性

  • 全面实现ARES API端点
  • 具有多个过滤器的复杂搜索（IČO、姓名、地址、法律形式、CZ-NACE等）
  • 注册处特定搜索（公共注册处、行业注册处、学校等）
  • 内置速率限制
  • 可选身份验证支持
  • 根据API文件正确命名捷克语

先决条件

  • Python 3.8或更高版本
  • pip（Python包管理器）

安装

快速安装

# Clone the repository
git clone https://github.com/yourusername/ares-mcp-server.git
cd ares-mcp-server

# Run automated setup
./run.sh  # macOS/Linux
# or
run.bat   # Windows

手动安装

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Create configuration
cp .env.example .env

配置

使用中的环境变量配置服务器 .env:

# Rate limiting (default: 100 requests per 60 seconds)
ARES_RATE_LIMIT_REQUESTS=100
ARES_RATE_LIMIT_WINDOW=60

# Optional authentication token
ARES_AUTH_TOKEN=your_token_here

# Logging level
LOG_LEVEL=INFO

Claude桌面配置

添加到您的Claude Desktop配置文件中：

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

视窗

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ares": {
      "command": "python3",
      "args": ["-m", "ares_mcp_server.server"],
      "cwd": "/path/to/ares-mcp-server"
    }
  }
}

可用工具

1. 寻找_经济实体

主搜索工具 -使用复杂过滤器搜索经济实体

参数：

  • start （可选）：起始位置（默认值：0）
  • pocet （可选）：结果数量（默认值：20，最大值：200）
  • razeni (可选): 排序顺序数组 ["ICO", "OBCHODNI_JMENO_DESC", 等]
  • ico （可选）：要搜索的IČO数数组
  • obchodniJmeno （可选）：企业名称
  • sidlo （可选）：地址筛选器对象
    • kodCastiObce：区号
    • kodObce：市政府代码
    • textovaAdresa：文本地址搜索
    • 等等
  • pravniForma （可选）：法律表格代码数组
  • financniUrad （可选）：税务局代码数组
  • czNace （可选）：CZ-NACE活动代码数组（最多5个）

2. 找到_经济实体

获取特定经济实体的详细信息

参数：

  • ico （必填）：IČO编号（8位数字）

3. 查找_注册表

在特定注册表中搜索

参数：

  • registry （必填）：注册表代码
    • vr公共记录（Public Registers）
    • res经济实体登记处（Economic Entities Registry）
    • rzp商业许可证（Trade Licensing）
    • nrpzs国家医疗服务提供者注册（Healthcare）
    • rpsh政党和运动登记册（Political Parties Registry）
    • rcns教会和宗教团体（Churches）
    • szr联合农业登记处（Agricultural Register）
    • rs学校注册（Schools）
    • ceu中央破产登记处（Central Bankruptcy Registry）
  • 加上与主搜索相同的搜索参数

4. 找到_注册表

通过IČO从特定注册表获取实体

参数：

  • registry （必填）：注册表代码
  • ico （必填）：IČO编号

5.有效期

验证IČO格式并检查是否存在

参数：

  • ico （必填）：IČO验证

6. 查找目标

搜索代码本和术语

7. 查找地址

搜索标准化地址

8. 查找通知

搜索通知批次

Claude Desktop中的示例用法

配置后，您可以直接在Claude Desktop中与ARES数据交互。以下是一些常见的用例：

🔍 基本公司搜索

问克劳德：“在ARES中搜索名称包含‘微软’的公司”

克劳德将使用：

vyhledat_ekonomicke_subjekty with:
- obchodniJmeno: "Microsoft"
- pocet: 10

📊 获取公司详细信息

询问克劳德：“获取IČO 26168685公司的详细信息”

克劳德将使用：

najit_ekonomicky_subjekt with:
- ico: "26168685"

✅ 验证IČO

问克劳德：“IČO 26168685有效吗？”

克劳德将使用：

validovat_ico with:
- ico: "26168685"

🏭 行业特定搜索

问克劳德：“查找布拉格的所有餐厅”

克劳德将使用：

vyhledat_ekonomicke_subjekty with:
- czNace: ["56"]  # Restaurants and food service
- sidlo: { "nazevObce": "Praha" }
- pocet: 50

📋 搜索多家公司

问克劳德：“获取IČO 26168685和00000019公司的信息”

克劳德将使用：

vyhledat_ekonomicke_subjekty with:
- ico: ["26168685", "00000019"]

🏢 注册表特定搜索

问克劳德：“在贸易登记处搜索软件公司”

克劳德将使用：

vyhledat_v_registru with:
- registry: "rzp"
- obchodniJmeno: "software"

发展

项目结构

ares-mcp-server/
├── ares_mcp_server/
│   ├── __init__.py
│   ├── server.py           # Entry point
│   ├── server_v3.py        # Main server implementation
│   ├── api_client_v3.py    # ARES API v3 client
│   └── tools_v3.py         # Tool definitions
├── tests/
├── examples/
├── requirements.txt
├── pyproject.toml
└── README.md

运行测试

source venv/bin/activate
pytest tests/

API文档

此服务器实现官方的ARES API。有关API的详细文档，请参阅：

更新日志

v0.3.0（2025-07-04）

  • 根据ARES API v3规范完成重建
  • 工具名称现在与API端点匹配（捷克语名称）
  • 与API文件相匹配的适当参数结构
  • 支持所有搜索筛选器，包括地址组件
  • 添加了特定于注册表的搜索端点
  • 添加了实用程序端点（代码簿、地址、通知）

许可证

MIT许可证

支持

对于问题或疑问：

  • 在GitHub上创建问题
  • 查看ARES API文件

致谢

该服务器与捷克共和国财政部提供的捷克ARES API集成。

相关 MCP