databazaar

databazaar-mcp

DataBazaar 用の MCP サーバーです。AI エージェントがデータセットを見つけ、プレビューし、購入し、販売するデータマーケットプレイスです。

DataBazaar はマーケットプレイスであり、決済ネットワークではありません。 有料取引はすべて Stripe で処理されます（販売者への支払いには Stripe Connect、サブスクリプションには Stripe Billing を使用します）。資金は購入者のカードから、登録済み販売者の Stripe Connect 対応銀行口座へ移動し、DataBazaar は 3% のプラットフォーム手数料を徴収します。暗号通貨、ピアツーピアの資産移転、送金業務は一切ありません。法的な仕組みは eBay や Etsy と同じです。つまり、マーケットプレイス運営者が規制対象の決済処理業者を介さずにユーザー資金を保有または移動することのないオンラインマーケットプレイスです。

クイックスタート（Claude.ai — リモートコネクター）

公開データの検索には、認証なしで Streamable HTTP を使用して https://api.databazaar.io/mcp/public に接続します。利用できるのは search_datasets、get_dataset、preview_sample です。全データのダウンロード（無料データを含む）、購入、非公開履歴、書き込みには認証済みエンドポイントが必要です。

Python 3（パッケージ不要）を使って、公開検索からサンプルのプレビューまでを実行する例です。

curl -fsS --max-time 20 https://databazaar.io/examples/first-retrieval.py -o first-retrieval.py
python3 first-retrieval.py --mcp

期待される結果は、success: true、scope: sample_only、サンプル行、および経過秒数です。これは全データの取得時間を測定するものではありません。 --mcp を指定しない場合、同じ例では REST を使用します。ガイドをご覧ください。

全データ（無料データを含む）の取得やアカウント操作には、DataBazaar の認証済みリモート MCP サーバー https://api.databazaar.io/mcp を使用します。 Claude.ai は標準の RFC 8414 メタデータドキュメントを通じて OAuth を検出し、 RFC 7591 Dynamic Client Registration を通じてクライアントとして自動登録されます。ポップアップで「Authorize」をクリックする以外に、手動での設定は不要です。

サインアップしてエージェントを認証した後、dataset_id を指定して get_download_url を呼び出します。 Python で全データを確認するには、環境変数に DATABAZAAR_API_KEY を設定して python3 first-retrieval.py --download を実行します（認証済みトランスポートを使う場合は --mcp を追加します）。 このスクリプトは 11 行すべてを検証し、取得時間を計測します。先にアカウントを設定する必要があります。また、サンプルの計測時間をオンボーディング全体の成功として報告しないでください。

クイックスタート（stdio — Claude Desktop / Cursor）

npx databazaar-mcp

認証情報がなくても、検索とサンプルの取得は利用できます。全データをダウンロードするには、npx -y databazaar-mcp auth login を実行するか、databazaar.io/operator/keys から取得したアカウント API キーを使用してください。

クイックスタート（Docker — stdio）

ローカルの stdio コンテナを使用するには、このリポジトリからビルドし、標準入力を開いたまま実行します。

docker build -t databazaar-mcp .
docker run --rm -i databazaar-mcp

サーバーの起動、ツールの確認、検索、サンプルのプレビューに認証情報は不要です。アカウント操作では、ローカルで環境変数を設定した後、docker run --rm -i -e DATABAZAAR_API_KEY databazaar-mcp を実行し、実行時に独自のキーを渡します。認証情報を Dockerfile に記載しないでください。

コンテナは stdio エントリーポイントを実行します。CI ではネットワークアクセスを無効にした状態で、初期化とツール／リソースの検出を確認します。マーケットプレイスでの操作は実行しません。

クイックスタート（ホスト型 HTTP — 長時間稼働するサービス）

npx --package databazaar-mcp databazaar-mcp-http
# Listens on port 8788 by default
# MCP endpoint: POST http://localhost:8788/mcp
# Health check: GET  http://localhost:8788/health

設定

実行前に、次の環境変数を設定します。

変数	必須	説明
DATABAZAAR_API_KEY	全データのダウンロード／アカウント用ツールに必要	API キー（dbz_live_...）
DATABAZAAR_API_URL	いいえ	API エンドポイントの上書き（デフォルト：https://api.databazaar.io）
DATABAZAAR_BUDGET_LIMIT_USD	いいえ	クライアント向けの予算目安です。購入上限の強制設定は、アカウントの API キーで行ってください
DATABAZAAR_MCP_PORT	いいえ	HTTP トランスポートのポート（デフォルト：8788）

Claude Desktop / Cursor の設定（stdio）

MCP 設定ファイル（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "databazaar": {
      "command": "npx",
      "args": ["-y", "databazaar-mcp"]
    }
  }
}

ホスト型 HTTP トランスポートのセットアップ

databazaar-mcp-http を長時間稼働するプロセスとして実行してください。各 HTTP 呼び出し元は独自の Bearer アカウント認証情報を指定します。サーバーが環境変数の認証情報を呼び出し元に貸し出すことはありません。管理されたアカウント認証には、https://api.databazaar.io/mcp を使用してください。

# Start the HTTP MCP server
DATABAZAAR_MCP_PORT=8788 npx --package databazaar-mcp databazaar-mcp-http

# Configure your agent framework to connect via HTTP:
# URL: http://your-host:8788/mcp
# Method: POST (Streamable HTTP transport per MCP spec)

利用可能なツール

検索と発見

• find_data_for_task — タスクに基づいてデータセットを推奨し、why_relevant で関連性を説明します
• search_datasets — マーケットプレイス全体をキーワードとファセットで検索します
• check_coverage — 既知の公開ソースがすでに掲載されているかを確認します
• get_dataset — checkout_url と human_pitch を含む完全なメタデータを取得します
• preview_sample — サンプル行と、任意で生成された回答を取得します（購入不要）
• get_related_datasets — 同じカテゴリ内でタグの重複に基づく類似データセットを取得します
• log_data_gap — 未充足のデータニーズを記録します。必要に応じて報奨金を自動作成できます

購入

• buy_now — データセットをすぐに購入します（無料データセットには支払い方法は不要です）

購入後

• get_download_url — 有効期間1時間の署名付きダウンロード URL を取得します（無料データセットは購入不要）
• list_purchases — この API キーでのすべての購入を一覧表示します
• get_purchase_receipt — 節約した時間と支出額を示す費用対効果の領収書を取得します。human_summary をオペレーターに転送してください
• share_finding — 購入したデータセットから得られた分析結果を共有し、共有可能な URL を返します

出品と販売

• suggest_listing — 作成したデータセットの DataBazaar への出品を提案し、ワンクリックで承認できる URL を返します
• create_listing — 新しい下書きデータセットの出品を作成します
• get_upload_urls — サンプルファイルと完全なデータセットファイルをアップロードするための署名付き URL を取得します
• confirm_upload — ファイルのアップロードを確認し、サンプルの生成を開始します
• get_listing_status — 出品のステータスを確認します（サンプル生成中はポーリングしてください）
• update_listing — 下書きまたは有効な出品のメタデータを更新します
• set_schema — 列やフィールドを記述するデータスキーマを設定します
• publish_listing — 下書きの出品をマーケットプレイスに公開します

コミュニケーション

• contact_seller — 購入を確定する前に、データセットの販売者へメッセージを送信します

ツールの安全性分類

以下のすべてのツールには、readOnlyHint または destructiveHint を宣言する MCP の annotations ブロックが付いています。これにより、コネクタホストは適切なユーザープロンプトを表示できます。金銭を移動するツールには destructiveHint が付けられ、初回使用時にオペレーターによる対話型の同意が必要です。

カテゴリ	読み取り専用	破壊的
発見	search_datasets、get_dataset、preview_sample、find_data_for_task、check_coverage、get_related_datasets	log_data_gap
購入	—	buy_now
配信	get_download_url、list_purchases、get_purchase_receipt	share_finding、suggest_listing
販売	get_listing_status	create_listing、get_upload_urls、confirm_upload、update_listing、set_schema、publish_listing
メッセージ	—	contact_seller
クエリ	query_dataset	—

支払いと資金の取り扱い

buy_now は、請求を開始する唯一のツールです。次の処理を行います。

1. 運営者が登録したカードまたは保存済みの支払い方法に対して、Stripe の請求を承認します。DataBazaar が資金を預かることはありません。
2. Stripe Connect を通じて、販売者の確認済み銀行口座に売上金を決済します。DataBazaar は売上総額から 3% のプラットフォーム手数料を差し引きます。
3. 支払い前に 24 時間のエスクロー期間が設けられます（DataBazaar が資金を保管する口座ではなく、Stripe が管理するタイマーです）。この期間中に異議を申し立てることができます。
4. 暗号資産、有価証券、ギフトカード、その他の資産クラスを移転することはできません。このマーケットプレイスに掲載されるのはデータファイルのみです。決済手段は、Stripe を介した規制対象のカード決済です。

したがって、この MCP サーバーは Connectors Directory の「資金／暗号資産／金融資産の移転」という除外条件には該当しません。エージェントがサードパーティーのストアで注文できるようにする、Shopify／eBay／Etsy のコネクターと構造的に同じマーケットプレイス統合です。

プライバシーとデータの取り扱い

• プライバシーポリシー： databazaar.io/legal/privacy
• 利用規約： databazaar.io/legal/terms
• MCP サーバーは OAuth トークンをローカルの ~/.config/databazaar/token.json に保存します （モード 0600）。会話の内容、プロンプト、チャット履歴が DataBazaar API に送信されることはありません。送信されるのは、各ツールの inputSchema に示されている明示的なツール引数のみです。
• DataBazaar が収集するのは、マーケットプレイスの運営に必要なデータのみです （アカウントのメールアドレス、購入、出品、買い手と売り手のメッセージ）。
• Stripe は Stripe Elements／Checkout を介して買い手のブラウザーからカード情報を直接受け取ります。DataBazaar が PAN、CVC、有効期限を扱うことはありません。

サポート

DataBazaar のメールドメインは databazaar.com（Google Workspace）です。現在の連絡先については、上記の法的情報ページが正式な情報源です。

• プライバシー：[email protected]
• 法務／利用規約：[email protected]
• 一般サポート：[email protected]
• セキュリティに関する報告：[email protected]

リソース

• databazaar://categories — 利用可能なすべてのデータセットカテゴリー
• databazaar://recipes — 一連の操作例：検索→購入→ダウンロード、不足時の報奨金の提示、スクレイピング前のカバレッジ確認など
• databazaar://onboarding — 運営者向けの DataBazaar の平易な説明。貼り付けてすぐ使える紹介文も含まれます
• databazaar://agent/identity — エージェントの ID と設定
• databazaar://agent/spending — 支出の概要と購入履歴

ワークフローの例

購入：

1. find_data_for_task("train rent prediction model for SF 2024")
2. preview_sample(dataset_id, question="average rent by neighborhood")
3. buy_now(dataset_id)
4. get_download_url(purchase_id)
5. get_purchase_receipt(purchase_id)  → forward human_summary to operator

販売：

1. create_listing(title, description, category, pricing_type)
2. get_upload_urls(dataset_id)
3. (PUT file bytes to the returned signed URL)
4. confirm_upload(dataset_id, full_data_path)
5. get_listing_status(dataset_id)  → poll until sample ready
6. publish_listing(dataset_id, tos_confirmed=true, listing_terms_version="2026-10-09")

新しいバージョンのリリース

パッケージは2か所に公開されます。npm（成果物）と公式 MCP Registry（メタデータエントリー）です。リリースを完全に反映するには、両方を更新する必要があります。

事前準備（一度だけ）：

• パッケージ所有者の shagarwal として npm login します
• 2FA が有効になっています。--otp 用に認証アプリをご用意ください

リリース手順：

# 1. Bump the version in BOTH files (keep them in sync)
#    - packages/mcp/package.json       : "version"
#    - packages/mcp/server.json        : "version" AND "packages[0].version"

# 2. Build and publish to npm
cd packages/mcp
pnpm build
npm publish --access public --otp=XXXXXX

# 3. Verify npm has the new version
curl -s https://registry.npmjs.org/databazaar-mcp | \
  python3 -c "import json,sys; d=json.load(sys.stdin); print('latest:', d['dist-tags']['latest'])"

# 4. Commit + push the version bumps
git add packages/mcp/package.json packages/mcp/server.json
git commit -m "chore(mcp): release x.y.z"
git push origin main

# 5. Update the MCP Registry entry
#    Trigger the "Publish to MCP Registry" GitHub Actions workflow:
gh workflow run "Publish to MCP Registry" --ref main
gh run watch   # optional: follow the run

# 6. Verify the registry reflects the new version
curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=databazaar" | \
  python3 -m json.tool | head -30

ワークフロー（.github/workflows/publish-mcp-registry.yml）では、認証に GitHub Actions OIDC を使用します。シークレットは不要で、ローカルで実行したときに発生する mcp-publisher のデバイスフローのレート制限も回避できます。認証や公開手順の調整が必要になった場合は、このファイルを参照してください。

各リリースで維持する不変条件：

• package.json の mcpName: "io.github.shagarwal/databazaar" は必ず維持してください — これはレジストリが npm の所有権を検証するために使用します。削除すると、 レジストリへの公開に失敗します。
• server.json の説明は100文字以内にしてください — レジストリはそれより長い説明を 拒否します。長い紹介文はこの README、llms.txt、ホームページに記載し、 server.json には短い説明のみを記載してください。
• package.json の bin の値に ./ のプレフィックスを付けないでください — npm 11 は プレフィックスを黙って削除した後、その値を拒否し、公開された tarball から bin エントリーを削除します。./dist/index.js ではなく、dist/index.js を使用してください。

リンク

• データセットを閲覧
• API キーを取得
• API ドキュメント
• MCP ディスカバリー
• npm パッケージページ
• レジストリの掲載情報

テスト済みのワークフローと連携

• DeepSearchQA を CSV にエクスポート
• 過去の株価バーを調べる
• MCP、AI SDK、LangChain の例

このリリースでは、min_quality_score の値に 0～100 を使用します。これはサンプルの構造を測定するもので、顧客評価や事実の正確さを測定するものではありません。公開されている評価基準をご覧ください。

無料データも含め、完全なダウンロードには必ずサインイン済みのアカウントが必要です。公開ディスカバリーは、トークン不要のローカルサーバー、またはホストされた /mcp/public エンドポイントから利用できます。

ソースと問題の報告先：https://github.com/shagarwal/databazaar-mcp. マーケットプレイスへのフィードバック：https://databazaar.io/feedback.

掲載情報の出典と再利用条件

公開前に、create_listing または update_listing を通じて documentation.source_name を指定してください。元の情報源または作成者の名前を記載します。出典 URL は任意です。対象期間には documentation.coverage_status: "not_applicable" を指定できます。documentation.update_frequency では、固定のスナップショットか、更新を受け取るか、および後続バージョンが含まれるかを任意で説明できます。

license と documentation.license_url は、カスタムの再利用条件として任意で指定できます。両方とも空欄の場合は、掲載条件に同意することで、DataBazaar Open Use のもと、帰属表示なしで商用利用、変更、再配布、モデルのトレーニングが許可されます。アクセス料金は引き続き適用されます。tos_confirmed: true と listing_terms_version: "2026-10-09" を確認済みとして指定できるのは、提供者の許可を得た場合に限られます。公開中の再利用条件を変更する場合も、同じ同意が必要です。同意の記録がない古い掲載情報は、指定なしのままとなり、自動的にオープンにはなりません。

この公開クライアントをビルドしてテストする

npm install
npm test
npm run build
node dist/index.js

このリポジトリは、リリース済みの MCP クライアントをミラーしています。マーケットプレイス API とウェブアプリは別々に開発されています。サインインしなくても検索とサンプルを利用できますが、すべてのデータの取得とアカウント操作にはアカウント認証情報が必要です。サポート対象のインストール方法は、公開されている npm パッケージです：npx -y databazaar-mcp。

レジストリのレコードには、認証が必要な /mcp と、キー不要の /mcp/public の両方のトランスポートが記載されています。公開エンドポイントでは、検索、メタデータ、サンプルを利用できます。すべてのデータを取得するには、引き続きアカウント認証が必要です。過去のレジストリバージョンには、非公開の開発リポジトリが記載されている場合があります。クライアントのソースコードと課題管理には、この公開リポジトリを使用してください。