mcp-eureka

Name: mcp-eureka
Author: matematicsolutions

本地服务

github.com/matematicsolutions法律与政务45 周前更新

代码仓库

关于 mcp-eureka

mcp-eureka 是面向法律研究场景的 MCP 服务，连接波兰财政部 EUREKA 税务实践文档库。它可按条件检索税务解释并返回带签名、网址和日期的引用。

主要功能

01检索波兰税务实践文档
02按签名快捷查询
03按类别和日期筛选
04获取文档内容与元数据
05返回可核验引用

适用场景

01查找特定税务解释
02按签名核对文档
03筛选特定类别或日期的材料

MCP 相关

该 MCP 服务向 MCP 客户端提供搜索、签名查询、类别列表和文档获取工具。响应包含标题、网址、签名和发布日期等引用信息。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "matematicsolutions-mcp-eureka": {
      "command": "npx",
      "args": [
        "-y",
        "@matematicsolutions/mcp-eureka"
      ]
    }
  }
}

启动命令npx -y @matematicsolutions/mcp-eureka

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@matematicsolutions/mcp-eureka0.2.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
page	number	否	页码（从 0 开始）。用于分页。
query	string	否	搜索短语，例如 'fotowoltaika' 或 'ulga badawczo-rozwojowa'。
date_to	string	否	发布日期截止（YYYY-MM-DD）。
date_from	string	否	发布日期起始（YYYY-MM-DD）。
page_size	number	否	每页结果数（1-50）。默认值为 10。
signature	string	否	文档文号，完整值（'0112-KDIL3.4012.367.2026.2.AK'）或前缀（'0112-KDIL3'）。
full_phrase	boolean	否	true = 短语必须精确出现（通常无匹配结果）；false（默认）= 独立搜索各个词。
category_ids	array	否	来自词典（list_categories）的类别 ID。例如 [1] = 个别解释，[3] = 一般解释，[11] = 税务说明。

详细介绍

mcp-eureka

一个适用于 EUREKA 系统的 MCP（Model Context Protocol） 服务。该系统由 Ministerstwo Finansow / MF（波兰财政部）运营（eureka.mf.gov.pl），收录了 55 万多份波兰税务实践文件，包括 51.7 万多份 Krajowa Informacja Skarbowa / KIS（国家税务信息局）的个税解释、一般解释、税务说明，以及具有约束力的税率信息（WIS）和消费税信息（WIA）。

这是波兰最大的单一税务实践语料库，可供 Claude / Cursor / VS Code MCP Agent 使用，并提供可验证的引文（案号 + URL + 日期）。

状态：v0.1.0 | 许可证：MIT | 维护者：MateMatic

税务解释不是法律渊源，而是主管机关的实践（《税务条例》第 14a-14s 条）。法律保护仅适用于特定个税解释的申请人。

数据来源

EUREKA 门户的公开 JSON API（Angular SPA 后端，无需密钥），于 2026-07-08 在线验证：

POST /api/public/v1/wyszukiwarka/informacje/?size=N&page=N&sort=DT_WYD,desc - 搜索（筛选项：SYG、作为 ID 数组的 KATEGORIA_INFORMACJI、 DT_WYD_start/DT_WYD_end；请求正文中的 searchQuery）。? 前的尾随斜杠必不可少——省略后端会返回 HTTP 500。
GET /api/public/v1/informacje/{id} - 完整文件（元数据 + HTML 内容）。
GET /api/public/v1/pozycje-slownika/wyszukiwarka?kodSlownika=KATEGORIA_INFORMACJI - 类别字典（28 项）。

MCP 工具

search(query?, full_phrase?, signature?, category_ids?, date_from?, date_to?, page?, page_size?) - 带筛选条件的搜索；按发布日期降序排列。
get_interpretation(id) - 按 ID_INFORMACJI 获取完整文件（论点 + 内容前 3000 个字符）。
search_by_signature(signature) - 快捷搜索：按完整案号（0112-KDIL3.4012.367.2026.2.AK）或前缀（0112-KDIL3）搜索。
list_categories() - 返回 category_ids 对应的类别字典（ID -> 名称）。

每个响应都包含 structuredContent.citations（标题、url、案号、发布日期）——这是 Patron 及任何 MCP Agent 使用的约定格式。

快速开始

npm install
npm run build
npm start                # stdio transport

npm run drift            # consistency INSTRUCTIONS <-> TOOLS <-> ErrorCode
npm run test:parse       # offline - fixtures from real API responses
npm run smoke            # LIVE - eureka.mf.gov.pl (throttled 2 req/s)

MCP 客户端配置（mcp-servers.json）：

{
  "mcpServers": {
    "eureka": {
      "command": "node",
      "args": ["<path>/mcp-eureka/dist/index.js"]
    }
  }
}

MateMatic 波兰法律连接器

mcp-saos（普通法院/SN/TK/KIO）· mcp-nsa（NSA + 16 个 WSA）· mcp-eureka（本项目）· mcp-isap（Dz.U. + M.P.）· mcp-krs（KRS）· kio-orzeczenia-mcp（KIO）

连接器集群约定：一个连接器对应一个来源（单一来源）。每次调用都会返回可引用的来源，不修改内容，且无状态。

免责声明

数据来自财政部的 EUREKA 公共系统。该连接器不修改内容，会限制请求速率（最多 2 次请求/秒），并使用包含仓库地址的 User-Agent 标识自身。在具体案件中解释法律，需要你自行申请个税解释或咨询税务顾问。

许可证

MIT - 参见 LICENSE。

引用：MateMatic Solutions (2026), mcp-eureka - MCP server for Polish tax interpretations (EUREKA/KIS), https://github.com/matematicsolutions/mcp-eureka, MIT.

支持 Markdown

登录后评论