Prozorro MCP服务器
模型上下文协议(MCP)服务器,为人工智能模型提供无缝访问乌克兰政府采购数据的能力 窗口 -乌克兰的公共采购制度。
❗❗❗ 提供所有可用的功能需要有一个代理服务器和数据库,所以现在MCP API不公开。若要获取API URL和API令牌,请与作者联系。
特性
- 🔍 搜索投标:按EDRPOU代码、法定名称或日期范围提供高级搜索功能
- ⚡ 快速:API与Prozorro的公共采购数据库直接集成
- 🛠️ 易于集成:使用Claude Desktop和其他MCP客户端进行简单设置
可用工具
search_tenders
根据各种标准搜索政府招标(目前只有2025年的数据)。
参数:
EDRPOUCode(字符串,可选):组织的唯一标识符代码(乌克兰税务ID)legalName(string,可选):与组织法定名称匹配的子字符串dateFrom(字符串,可选):搜索的开始日期(ISO 8601格式,例如。,2025-01-01)dateTo(字符串,可选):搜索的结束日期(ISO 8601格式,例如。,2025-12-31)limit(number,可选):要返回的最大记录数(默认值:100,最大值:1000)
退货: 包含详细信息的投标对象数组,包括投标ID、标题、组织详细信息、日期和采购状态。
安装
方法1:从npm安装(推荐)
安装MCP服务器最简单的方法是通过npm:
npm install -g prozorro-mcp-server安装后,添加到Claude Desktop配置:
视窗: %APPDATA%\Claude\claude_desktop_config.json\ macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\ Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"prozorro": {
"command": "prozorro-mcp-server",
"env": {
"PROZORRO_API_TOKEN": "your-api-token-here",
"PROZORRO_SERVICE_URL": "mcp-api-url-here"
}
}
}
}重新启动Claude Desktop,您就可以使用服务器了!
备注:在Linux/macOS上,如果您遇到权限问题,可能需要使用 sudo npm install -g prozorro-mcp-server 或者配置npm使用用户目录。方法2:从GitHub安装
- 从GitHub通过npm全局安装:
npm install -g git+https://github.com/VladyslavMykhailyshyn/prozorro-mcp-server.git- 添加到Claude桌面配置:
视窗: %APPDATA%\Claude\claude_desktop_config.json\ macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"prozorro": {
"command": "prozorro-mcp-server",
"env": {
"PROZORRO_API_TOKEN": "your-api-token-here",
"PROZORRO_SERVICE_URL": "mcp-api-url-here"
}
}
}
}- 重新启动克劳德桌面 -服务器将准备就绪!
方法3:本地开发安装
- 克隆存储库:
git clone https://github.com/VladyslavMykhailyshyn/prozorro-mcp-server.git
cd prozorro-mcp-server- 安装依赖项:
npm install- 构建项目:
npm run build- 添加到Claude桌面配置 (使用绝对路径):
{
"mcpServers": {
"prozorro": {
"command": "node",
"args": ["/absolute/path/to/prozorro-mcp-server/build/index.js"],
"env": {
"PROZORRO_API_TOKEN": "your-api-token-here",
"PROZORRO_SERVICE_URL": "https://prozorro.gov.ua"
}
}
}
}配置
服务器需要特定的环境变量才能正常运行。您可以在Claude Desktop配置或 .env 本地开发文件。
| 变量 | 描述 | 必填 | 示例 |
|---|---|---|---|
PROZORRO_API_TOKEN | 您的Prozorro API Bearer代币 | 是 | Bearer abc123... |
PROZORRO_SERVICE_URL | API的基本URL | 是 | https://mcp-service-url.... |
正在获取API凭据
要获取Prozorro的API凭据和URL,请执行以下操作:
- 联系作者
- 检索API令牌和URL
- 在配置中使用令牌和URL
常用工作流
工作流程1:按组织搜索标书
1. Use search_tenders with EDRPOUCode to find all tenders from a specific organization
2. Review the returned tender details including dates, amounts, and status
3. Filter results by date range if needed工作流程2:查找最近的投标
1. Use search_tenders with dateFrom and dateTo parameters
2. Optionally filter by organization name using legalName
3. Limit results for better performance故障排除
服务器未出现在Claude Desktop中
- 检查路径是否正确
claude_desktop_config.json是正确的 - 确保您已使用以下工具构建了项目
npm run build - 验证是否安装了Node.js(需要版本18或更高版本)
- 重新启动克劳德桌面
- 检查Claude Desktop日志是否有错误
API请求失败
- 验证您的
PROZORRO_API_TOKEN有效且未过期 - 检查
PROZORRO_SERVICE_URL是正确的 - Prozorro API可能有速率限制-请考虑在请求之间添加延迟
- 需要连接到prozorro.gov.ua的网络
- 部分标书可能暂时无法获取
身份验证错误
- 确保您的API令牌包括
Bearer前缀(如果需要) - 检查您的令牌是否具有必要的权限
- 验证令牌是否未过期
发展
项目结构
prozorro-mcp-server/
├── src/
│ ├── index.ts # Main MCP server entry point
│ ├── tenders.ts # Tender search implementation
│ └── types.ts # TypeScript type definitions
├── build/ # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md以开发模式运行
# Watch mode - auto-rebuild on changes
npm run dev
# In another terminal
npm start生产大楼
npm run buildapi信息
该服务器使用Prozorro公共API检索投标信息。有关Prozorro系统和可用数据的更多详细信息:
- Prozorro网站: https://prozorro.gov.ua/
- API 文档: https://prozorro.gov.ua/api
- 数据格式:包含详细招标信息的JSON响应
许可证
国际学生委员会
贡献
欢迎投稿!请随时提交拉取请求。
联系
有关问题和疑问,请使用 页面。
