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 客户端中浏览交互式卡片，并明确要求 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 回退内容。请参阅扩展支持矩阵，了解客户端支持情况。

请参阅Marketplace Explorer 指南，了解本地 HTTP 测试、临时隧道安全、隐私与署名行为、UI 开发和发布检查。

本项目采用 MIT 许可证授权。