Eoa MCP Server

EOA MCP服务器

生产就绪的MCP（模型上下文协议）服务器，用于通过EOA公共注册表（EOA.conet.gr）搜索希腊保险中介机构。

设置

先决条件

• Node.js 18+
• EOA API证书（AUSER/APSWORD）

安装

cd mcp_server
npm install

环境变量

跑

发展 （带手表）：

npm run dev

生产:

npm run build
npm start

端点

MCP工具

所有工具返回JSON results，可选 total, source_note，以及 errors.

1. search_intermediaries

按查询和筛选器进行常规搜索。

输入：

这些日期参数被传递给EOA检索API作为 filter.gemiIncorporationDateFrom 和 filter.gemiIncorporationDateTo （包括日历日期）。当应用绑定时，不包括没有GEMI注册日期的配置文件。

例子：

{
  "query": "ΠΛΥΤΑΡΙΑΣ",
  "license_status": "active",
  "page": 1,
  "page_size": 20,
  "include_total": true
}

2. get_intermediary_by_vat

通过增值税号码获得单个中介。

输入：

例子：

{
  "vat": "998368964"
}

3. get_intermediary_by_gemi

通过GEMI注册号获得单个中介。

输入：

例子：

{
  "gemi": "69583903000"
}

4. search_intermediaries_in_bbox

在地理边界框内搜索。

输入：

例子：

{
  "latitude_from": 37.96,
  "latitude_to": 38.00,
  "longitude_from": 23.71,
  "longitude_to": 23.75,
  "include_total": true
}

5. list_legal_types

返回合法类型ID到希腊语描述的映射。无输入。

示例响应：

{
  "results": {
    "1": "ΑΕ",
    "2": "ΟΕ",
    "4": "ΕΕ",
    ...
  },
  "source_note": "EOA public registry aggregation; check lastUpdate for freshness.",
  "errors": []
}

输出格式

所有搜索工具返回：

{
  "results": [
    {
      "profileType": "P|G",
      "vatnumber": ".........",
      "geminumber": "...",
      "agentName": "...",
      "gemiTradeName": "...",
      "gemiIncorporationDate": "YYYY-MM-DD",
      "keeeRegistrationClass": "...",
      "keeeLicenceExpiration": "YYYY-MM-DD",
      "gemiBusinessAddress": "...",
      "gemiPhoneNumber": "...",
      "latitude": 0,
      "longitude": 0,
      "lastUpdate": "ISO-8601"
    }
  ],
  "total": 123,
  "source_note": "EOA public registry aggregation; check lastUpdate for freshness.",
  "errors": []
}

• total 仅在以下情况下存在 include_total: true.
• errors 包含任何上游或验证错误。

非功能性特征

• 速率限制：每个IP每分钟60个请求
• 缓存：相同请求的10分钟TTL（在内存中，可为Redis交换）
• 输入验证：增值税9位数，page_size≤50，page≥1，bbox边界，可选GEMI注册日期范围(YYYY-MM-DD，从≤到）
• 安全：头盔，没有敏感的头部日志记录，v1中没有base64图像