mcp-eureka

mcp-eureka

Ministerstwo Finansow / MF（財務省）の EUREKA システム（eureka.mf.gov.pl）向けの MCP（Model Context Protocol） サーバーです。ポーランドの税務実務に関する 550,000 件以上の文書を収録しており、その中には Krajowa Informacja Skarbowa / KIS（国税情報局）による 517,000 件以上の個別税務解釈（税務解釈）、一般解釈、税務解説、拘束力のある税率情報（WIS）および物品税情報（WIA）が含まれます。

ポーランド最大の税務実務コーパスを、検証可能な引用情報（署名＋URL＋日付）とともに、Claude / Cursor / VS Code の MCP エージェントで利用できます。

ステータス：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 エージェントが利用する契約です。

クイックスタート

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）

フリートの規約：コネクター 1 つにつきソース 1 つ（シングルソース）です。すべての呼び出しで、引用可能なソースを返します。コンテンツは一切変更せず、ステートレスです。

免責事項

データは財務省の公開 EUREKA システムから取得しています。このコネクターはコンテンツを変更せず、リクエストを制限し（最大 2 req/s）、リポジトリのアドレスを含む User-Agent を使用して自身を識別します。個別の事案における法律の解釈には、ご自身による個別解釈の取得、または税務アドバイザーへの相談が必要です。

ライセンス

MIT - LICENSE をご覧ください。

引用：MateMatic Solutions（2026）、mcp-eureka - ポーランドの税務解釈（EUREKA/KIS）向け MCP サーバー、https://github.com/matematicsolutions/mcp-eureka、MIT。