Mcp Eureka

io.github.matematicsolutions由 GitHub 帳號 matematicsolutions 發布v0.2.0更新於 Oct 24, 2026

MCP server for Polish tax interpretations (KIS/MF) via EUREKA with citations.

發布方自己的服務:Eureka EHR

已驗證STDIO僅桌面金融知識與記憶

概覽

AI 產生的概覽

本機 MCP 伺服器,讓助理檢索並閱讀波蘭財政部 EUREKA 系統中的稅務解釋等文件,並附上引用。

可以做什麼
依查詢詞、片語、類別、文號或日期範圍檢索 EUREKA 文件,依發布日期由新到舊排序並分頁。依文件 ID 取得完整文件,包含論點及正文前段。依完整或部分文號查找文件。列出用於篩選的類別字典。每次回應都附上標題、連結、文號與發布日期的引用資訊。
適用情境
適合助理需要查找波蘭稅務解釋、一般解釋、稅務說明或 WIS/WIA 資訊並加以引用的情境。著重於波蘭稅務實務的法律與稅務檢索,而非一般網路搜尋。
執行需求
以 npm 套件形式透過 npx 或 node 在本機以 stdio 執行。未宣告 API 金鑰、帳號、環境變數或請求標頭。會呼叫公開的 EUREKA JSON API,因此需要能連線至財政部入口網站的網路。
安裝前請注意
會將檢索詞傳送給公開的 EUREKA 入口網站這個第三方。稅務解釋是稅務機關的實務見解而非法律淵源,法律保護僅適用於該個別解釋的申請人;README 建議取得自己的個別解釋或稅務顧問意見。此伺服器版本為 0.1.0。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Eureka,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mcp-eureka

An MCP (Model Context Protocol) server for the EUREKA system of the Ministerstwo Finansow / MF (Ministry of Finance) (eureka.mf.gov.pl) - 550,000+ documents of Polish tax practice, including 517,000+ individual interpretacje podatkowe (tax interpretations) of the Krajowa Informacja Skarbowa / KIS (National Revenue Information), general interpretations, tax explanations, and binding rate (WIS) and excise (WIA) information.

The largest single corpus of tax practice in Poland, available to Claude / Cursor / VS Code MCP agents with verifiable citations (signature + URL + date).

Status: v0.1.0 | License: MIT | Maintainer: MateMatic

Tax interpretations are not a source of law - they are the practice of authorities (art. 14a-14s of the Tax Ordinance). Legal protection applies to the applicant of a given individual interpretation.

Data source

The public JSON API of the EUREKA portal (Angular SPA backend, no key required), verified live on 2026-07-08:

  • POST /api/public/v1/wyszukiwarka/informacje/?size=N&page=N&sort=DT_WYD,desc - search (filters: SYG, KATEGORIA_INFORMACJI as an array of ids, DT_WYD_start/DT_WYD_end; searchQuery in the body). The trailing slash before ? is mandatory - without it the backend returns HTTP 500.
  • GET /api/public/v1/informacje/{id} - full document (metadata + HTML content).
  • GET /api/public/v1/pozycje-slownika/wyszukiwarka?kodSlownika=KATEGORIA_INFORMACJI - category dictionary (28 entries).

MCP tools

  • search(query?, full_phrase?, signature?, category_ids?, date_from?, date_to?, page?, page_size?) - search with filters; sorted by issue date descending.
  • get_interpretation(id) - full document by ID_INFORMACJI (thesis + first 3000 characters of content).
  • search_by_signature(signature) - shortcut: by signature, full (0112-KDIL3.4012.367.2026.2.AK) or prefix (0112-KDIL3).
  • list_categories() - category dictionary (id -> name) for category_ids.

Every response includes structuredContent.citations (title, url, signature, issue_date) - the contract consumed by Patron and any MCP agent.

Quickstart

bash
npm installnpm run buildnpm start                # stdio transport
npm run drift            # consistency INSTRUCTIONS <-> TOOLS <-> ErrorCodenpm run test:parse       # offline - fixtures from real API responsesnpm run smoke            # LIVE - eureka.mf.gov.pl (throttled 2 req/s)

MCP client configuration (mcp-servers.json):

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

MateMatic Polish-law connectors

mcp-saos (common courts/SN/TK/KIO) · mcp-nsa (NSA + 16 WSA) · mcp-eureka (this one) · mcp-isap (Dz.U. + M.P.) · mcp-krs (KRS) · kio-orzeczenia-mcp (KIO)

Fleet convention: one connector = one source (single-source). Every call returns a citable source, zero content modification, stateless.

Disclaimer

The data comes from the public EUREKA system of the Ministry of Finance. The connector does not modify content, throttles requests (max 2 req/s), and identifies itself with a User-Agent carrying the repo address. Interpreting the law in a specific case requires your own individual interpretation or the opinion of a tax advisor.

License

MIT - see LICENSE.

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

來源:README.md,提交 de3e64e

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Eureka 整合