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代码等）
快速开始
- 安装服务器：
git clone https://github.com/yourusername/ares-mcp-server.git
cd ares-mcp-server
pip install -e .- 添加到Claude桌面配置：
{
"mcpServers": {
"ares": {
"command": "python3",
"args": ["-m", "ares_mcp_server.server"],
"cwd": "/path/to/ares-mcp-server"
}
}
}- 重启克劳德桌面，开始搜索捷克公司！
特性
- 全面实现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=INFOClaude桌面配置
添加到您的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的详细文档，请参阅：
- ARES Swagger用户界面
- ARES网站
- API基本URL:
https://ares.gov.cz/ekonomicke-subjekty-v-be/rest
更新日志
v0.3.0（2025-07-04）
- 根据ARES API v3规范完成重建
- 工具名称现在与API端点匹配（捷克语名称）
- 与API文件相匹配的适当参数结构
- 支持所有搜索筛选器，包括地址组件
- 添加了特定于注册表的搜索端点
- 添加了实用程序端点（代码簿、地址、通知）
许可证
MIT许可证
支持
对于问题或疑问：
- 在GitHub上创建问题
- 查看ARES API文件
致谢
该服务器与捷克共和国财政部提供的捷克ARES API集成。