Budna MCP

Budna MCP

互換性のある任意の MCP クライアントから、Budna の公開マーケットプレイスデータを利用できます。Budna MCP は読み取り専用です。アカウントや API キーは不要で、マーケットプレイスのデータを変更することもできません。

クイックスタート

Shell（macOS / Linux）

Node.js や Rust を使わずに、ビルド済みバイナリをインストールします。

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/budna-marketplace/mcp/releases/latest/download/budna-mcp-installer.sh | sh

PowerShell（Windows）

PowerShell 5.1 以降で実行します。

irm https://github.com/budna-marketplace/mcp/releases/latest/download/budna-mcp-installer.ps1 | iex

インストーラーによってディレクトリが PATH に追加された場合は、ターミナルを再起動してから budna-mcp --versionを確認してください。

npm / npx

Node.jsが必要です。

npm install --global @budna-marketplace/mcp

npx 経由でサーバーを起動するクライアントの場合：

command: npx
arguments: --yes @budna-marketplace/mcp

Homebrew

brew install budna-marketplace/tap/budna-mcp

Homebrew は Rust を自動的にインストールし、ソースからビルドします。

Cargo

Rust 1.88 以降が必要です。

公開済みの最新リリースをインストールします。

cargo install budna-mcp --locked

ローカルのチェックアウトからインストールするには：

cargo install --path crates/budna-mcp --locked

Codex に追加する

macOS または Linux の場合：

codex mcp add budna -- "$(command -v budna-mcp)"
codex mcp get budna

Windows PowerShell の場合：

$budna = (Get-Command budna-mcp).Source
codex mcp add budna -- $budna
codex mcp get budna

サーバーを追加したら、新しい Codex タスクを開始して、次のように依頼します。

Budna を使って、公開されているカメラの出品を探してください。

Codex MCP ドキュメントでは、プロジェクト単位の設定やその他のクライアントオプションについて説明しています。

別の stdio MCP クライアントに追加する

引数を指定せず、command -v budna-mcp（Windows では(Get-Command budna-mcp).Source）で返される絶対パスを設定します。

command: /absolute/path/to/budna-mcp
arguments: none

JSON 設定を使うクライアントの場合：

{
  "mcpServers": {
    "budna": {
      "command": "/absolute/path/to/budna-mcp",
      "args": []
    }
  }
}

できること

Budna MCP は、公開データを読み取り専用で扱う 11 個のツールを提供します。

• 出品、カテゴリ、フィルター、フィルターの選択肢を検索します。
• 出品、属性、関連する出品、出品者の出品、公開されている出品者プロフィール、入札の概要、評価の概要を確認します。
• 互換性のある MCP Apps クライアントでは、インタラクティブなカードを閲覧し、選択した 2～4 件の出品を AI に比較するよう明示的に依頼できます。

サインイン、入札、オファー、購入、メッセージ送信、閲覧記録、マーケットプレイスデータの変更はできません。

本番環境以外で使用する

API リクエスト、公開出品リンク、画像が同じ環境を参照するよう、以下の値をまとめて設定します。

設定	用途
BUDNA_API_URL	Budna API のベース URL。該当する場合は /api/v1 を含めます。
BUDNA_PUBLIC_LISTING_ORIGIN	返される出品リンクに使用するオリジン。
BUDNA_IMAGE_ORIGIN	返される画像 URL と App CSP に使用するオリジン。

リモート API の URL には HTTPS が必要です。HTTP が受け付けられるのは、ループバック開発サーバーに限られます。出品と画像の値には、認証情報、パス、クエリ、フラグメント、ワイルドカードホストを含まない、正規の HTTPS オリジンを指定する必要があります。バイナリは .env ファイルを自動で読み込みません。.env.exampleは参考資料です。

たとえば、別の環境用に Codex サーバーを個別に登録するには：

codex mcp add budna-nonprod -- /absolute/path/to/budna-mcp \
  --api-url https://api.your-environment.example/api/v1 \
  --public-listing-origin https://marketplace.your-environment.example \
  --image-origin https://images.your-environment.example

クライアントから指定できる場合は、同等の環境変数も使用できます。

インタラクティブカード

Marketplace Explorer はバイナリに組み込まれています。MCP Apps 拡張機能に対応しているクライアントでは、リスティングカード、詳細、関連リスティング／販売者のリスティング、比較対象の選択を表示できます。それ以外のクライアントには、同じテキストと構造化された JSON のフォールバックが提供されます。クライアントの対応状況については、拡張機能のサポートマトリックスをご覧ください。

ローカル HTTP テスト、一時トンネルの安全性、プライバシーと帰属表示の動作、UI 開発、リリース前の確認については、Marketplace Explorer ガイドをご覧ください。

このプロジェクトはMIT ライセンスの下でライセンスされています。