Eu Cellar

@pipeworx/eu-cellar

欧州連合出版局が発行したあらゆる文書 — 官報の法令、条約、統合テキスト、COM提案、欧州司法裁判所の判決 — を、CELLARセマンティックリポジトリの公開SPARQLエンドポイントから、タイトルで検索し、CELEX番号で閲覧できます。

Pipeworx の一部です。AIエージェントを1879以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれも行っていません。

ツール

• cellar_search_works(query, resource_type?, since?, until?, limit?) — EUのすべてのリソースタイプを対象とした全文タイトル検索です。CELEX、日付、リソースタイプ、EUR-Lexへの直接リンクを返します。
• cellar_work(celex? | cellar_id?) — 1件の文書のカタログエントリーです。英語タイトルすべて、文書の日付、施行中フラグ、リソースタイプ、英語ラベル付きのEuroVoc主題概念、起草機関を返します。
• cellar_sparql(query, limit?) — リポジトリに対して独自のSELECTまたはASKクエリを実行します。書き込みは拒否され、結果数には上限があります。

認証

キーは不要です。登録もキーも不要で、公表済みの利用枠もありません。

eur-lex パックとの関係

どちらもpublications.europa.euと通信しますが、重複するものではありません。eur-lex は法令遵守に特化した厳選されたインターフェースです。約14件の名前付き法令（GDPR、AI Act、DORAなど）を手作業で管理するインデックス、条文レベルのテキスト抽出、CJEU判決の検索機能を備え、SPARQLの利用範囲は法令に固定されています。このパックはリポジトリそのものです。あらゆるリソースタイプに加え、任意のSELECT専用クエリツールを提供します。

「GDPR第17条には何と書かれているか」を調べるにはeur-lexを使います。「EUはXについて何を公表したか」や、まだツール化されていないグラフに関する質問には、こちらを使ってください。

データソース

• https://publications.europa.eu/webapi/rdf/sparql — 共通データモデル（cdm:）グラフを提供するCELLAR SPARQLエンドポイント（Virtuoso）です。
• http://publications.europa.eu/resource/cellar/{id} — エンドポイントが返すWork URIです。

注意点（すべて2026-09-17に実環境で検証済み）

• 全文検索にはFILTER(CONTAINS(...))ではなくbif:containsが必要です。 エンドポイントはVirtuosoです。?titleに対するCONTAINSフィルターはリポジトリ内のすべての表現をスキャンするため、タイムアウトします。全文検索には?title bif:contains "'phrase'"を使います。複数単語のフレーズでは、Virtuosoが必要とする内側の単一引用符に注意してください。
• CELEXリテラルには型が指定されています。 ?w cdm:resource_legal_id_celex "32024R1689"では何も一致しません。^^xsd:stringが必要です。エラーではなく、行数ゼロのHTTP 200が返ります。
• タイトルは言語タグのあるものとないものの両方で返されます。 lang(?title) = "en"で絞り込むと、リポジトリの大部分が気付かれずに除外されます。式の言語URIで絞り込んでください。これはモデル化された事実です。
• 1件のWorkから多数の行が返ります。 （タイトル×タイプ×主題×著者）の直積により、1つの文書から20件のバインディングが返ることがあります。cellar_workはこれらを集約しますが、手書きのSPARQLでは集約されません。
• format=はクエリパラメーターです。 Acceptヘッダーだけでは一貫して処理されず、JSONを要求したのにRDF/XMLが返ることがあります。
• 不正なクエリでも、HTMLエラーページを伴うHTTP 200が返ります。 そのまま解析すると「結果なし」と解釈されます。このパックでは、クエリを拒否されたものとしてエラーにします。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "eu-cellar": {
      "url": "https://gateway.pipeworx.io/eu-cellar/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/eu-cellar/mcp の tools/list は、上記の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加えて、約 30 個の共有ツールが表示されます。接続時の initialize レスポンスに正確な対象範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、このパックが対応していない質問にも、カタログ全体を対象に振り分ける ask_pipeworx を介して回答できるため、MCP サーバーをもう 1 つ追加する必要がありません。現在、メタツールを含めずにパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキストのコストが、振り分けの利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度接続してください。

または、Pipeworx ゲートウェイ全体に接続すれば、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1879 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/cellar_search_works \
  -H 'Content-Type: application/json' \
  -d '{"query":"carbon border adjustment","limit":4}'

最初の呼び出しにアカウントは必要ありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/cellar_search_works を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも必要ありません。

{
  "mcpServers": {
    "eu-cellar": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-eu-cellar"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-eu-cellar

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを利用できますが、ask_pipeworx による振り分けはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Eu Cellar data" })

ゲートウェイが適切なツールを選択し、引数を自動的に設定します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT