E Oglasna MCP

e-Oglasna MCP服务器

模型上下文协议（MCP）服务器，提供对克罗地亚e-Oglasna法律通知API的访问。该服务器允许人工智能代理从克罗地亚官方司法系统搜索和检索法律通知、破产程序和法院文件。

（克罗地亚语）e-Oglasna MCP服务器

模型上下文协议（MCP）服务器，允许访问克罗地亚共和国司法电子广告牌的API。该服务器允许人工智能代理（例如Claude Code）搜索和访问来自克罗地亚共和国官方司法系统的法律公告，破产程序和法院文件。

特性

• API全面覆盖：已实现所有e-Oglasna API端点
• 速率限制：内置速率限制（1000/小时，每5秒5次）
• 错误处理：使用适当的MCP错误代码进行全面的错误处理
• 搜索工具：搜索所有通知、法院通知、破产、机构通知
• 细节检索：通过UUID获取特定通知详细信息
• 法庭信息：检索系统中所有法院的列表
• 导出访问权限：访问存档的通知文件

安装

1. 克隆或创建项目：

mkdir e-oglasna-mcp-server
cd e-oglasna-mcp-server

1. 保存文件：

- 将主服务器代码另存为 index.js - 保存package.json - 将此README另存为 README.md

1. 安装依赖项：

npm install

1. 制作可执行文件（如果需要）：

chmod +x index.js

用法

使用克劳德桌面

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

在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "e-oglasna": {
      "command": "node",
      "args": ["/path/to/your/e-oglasna-mcp/index.js"]
    }
  }
}

独立测试

npm start

可用工具

1. search_all_notices

搜索整个系统中的所有通知。

参数：

• text （string）：搜索文本（案例编号、标题、主题、OIB）
• dateFrom （日期）：发布日期（YYYY-MM-DD）
• dateTo （日期）：发布日期至（YYYY-MM-DD）
• noticeSourceType （数组）：按来源筛选\[“法院”、“机构”、“NOTARY_PUBLIC”\]
• page （整数）：页码（默认值：0）
• sort （数组）：排序条件\[“datePublished”，“expirationDate”\]

2. get_notice_details

获取有关特定通知的详细信息。

参数：

• uuid （字符串，必填）：注意UUID

3. search_court_notices

法院的搜查通知。

参数：

• text （字符串）：搜索文本
• dateFrom （日期）：发布日期
• dateTo （日期）：发布日期至
• courtCode （数组）：要过滤的法院代码
• caseType （数组）：案例类型\[“NATURAL_PERSON_BANKRUPTCY”、“LEGAL_PERSON_BANKRUBTCY”和“OTHER”\]
• debtorOib （数组）：债务人OIB编号
• page （整数）：页码

4. search_bankruptcies

搜索法人破产程序。

参数：

• text （string）：公司名称、OIB或搜索文本
• dateFrom （日期）：发布日期
• dateTo （日期）：发布日期至
• courtCode （array）：法院代码
• debtorOib （数组）：公司OIB编号
• page （整数）：页码

5. search_consumer_bankruptcies

搜索自然人（消费者）破产程序。

参数：

• text （string）：人名、OIB或搜索文本
• dateFrom （日期）：发布日期
• dateTo （日期）：发布日期至
• courtCode （array）：法院代码
• debtorOib （数组）：个人OIB编号
• page （整数）：页码

6. search_institution_notices

搜索来自机构（如国际泳联）的通知。

参数：

• text （字符串）：搜索文本
• dateFrom （日期）：发布日期
• dateTo （日期）：发布日期至
• institutionNoticeType （数组）：通知类型\[“CALL_FOR_ADDRES_SUBMISSION”，“OTHER”\]
• page （整数）：页码

7. get_all_courts

获取系统中所有法院的列表。

参数： 无

8. get_export_files

获取可用导出/存档文件的列表。

参数： 无

示例用法

一旦配置了Claude Desktop，您可以问：

• “搜索萨格勒布最近的破产程序”
• “查找本周发布的所有法院通知”
• “获取通知UUID abc-123-def的详细信息”
• “显示所有可用的球场”
• “搜索提及公司OIB 12345678901的通知”

速率限制

服务器实现与官方API相同的速率限制：

• 每小时最多1000个请求
• 每5秒窗口最多5个请求

如果超过限制，服务器将返回相应的错误消息。

错误处理

服务器处理所有常见的API错误：

• 429：超出费率限制
• 404：未找到资源
• 400：请求参数无效
• 500：系统错误

发展

以开发模式运行

npm run dev

项目结构

e-oglasna-mcp/
├── index.js          # Main MCP server implementation
├── package.json      # Node.js dependencies and scripts
└── README.md         # This file

API文档

此MCP服务器基于官方e-Oglasna API文档。有关响应格式和数据结构的详细信息，请参阅API原始文档，网址为 https://e-oglasna.pravosudje.hr/dokumenti/api.

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 彻底测试
5. 提交拉取请求

支持

有关此MCP服务器的问题，请在GitHub存储库中创建问题。

有关潜在e-Oglasna API的问题，请参阅克罗地亚司法系统的官方文件。