# @budna-marketplace/mcp 中文文档

规范地址：https://npmcn.com/package/%40budna-marketplace/mcp/

版本：0\.8\.0
npm 元数据更新时间：2026-10-30T20:54:01.835Z
中文译文更新时间：2026-11-08T20:28:14.133Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40budna-marketplace/mcp
原文对照：https://npmcn.com/package/%40budna-marketplace/mcp/?lang=original
项目主页：https://github.com/budna-marketplace/mcp
源码仓库：https://github.com/budna-marketplace/mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：43 kB，9 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=14\.14
- 运行依赖：1 个
- 首次发布：2026-10-27T21:28:54.703Z
- 最新版本发布：2026-10-30T20:54:01.496Z
- 近 30 天下载量：2463（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

Budna市场和MCP客户账户整合

## 安装

```sh
npm install @budna-marketplace/mcp
```

也可以使用：`pnpm add @budna-marketplace/mcp`、`yarn add @budna-marketplace/mcp`、`bun add @budna-marketplace/mcp`

## README

# 布德纳 MCP

[![build](https://img.shields.io/github/actions/workflow/status/budna-marketplace/mcp/core.yml?branch=main)](https://github.com/budna-marketplace/mcp/actions/workflows/core.yml) [![crates.io](https://img.shields.io/crates/v/budna-mcp.svg)](https://crates.io/crates/budna-mcp) [![npm](https://img.shields.io/npm/v/@budna-marketplace/mcp.svg)](https://www.npmjs.com/package/@budna-marketplace/mcp) [![MCP Registry](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fregistry.modelcontextprotocol.io%2Fv0.1%2Fservers%2Fio.github.budna-marketplace%252Fmcp%2Fversions%2Flatest&query=%24.server.version&label=MCP+Registry&prefix=v&color=blue)](https://registry.modelcontextprotocol.io/?q=io.github.budna-marketplace%2Fmcp) [![Homebrew](https://img.shields.io/badge/dynamic/regex?url=https%3A%2F%2Fraw.githubusercontent.com%2Fbudna-marketplace%2Fhomebrew-tap%2Fmain%2FFormula%2Fbudna-mcp.rb&search=version+%22%28%5B%5E%22%5D%2B%29%22&replace=v%241&label=Homebrew&logo=homebrew&logoColor=white&color=FBB040)](https://github.com/budna-marketplace/homebrew-tap)

从任何兼容的MCP客户端使用 Budna. 探索没有账户或API密钥的公共市场,或可选择连接您的 Budna 账户,以便您的 AI 助手可以读取自己的账户,列表,出价,报价,监视列表,保存搜索,购买,销售,争议,消息,支付,通知和评级,并有您选择的权限. Budna MCP只读:它不能改变市场数据.

## 快开始

### 外壳( macOS / Linux)

安装一个没有 Node.js 或 Rust 的预建二进制 :

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

### Power Shell (窗户)

运行在 PowerShell 5.1 或更新 :

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

如果安装者将其目录添加到 PATH 中, 则重新启动您的终端, 然后检查 `budna-mcp --version`。 。 。 .

### npm / npx 时间轴

要求数 [节点.js](https://nodejs.org/)。 。 。 .

```bash
npm install --global @budna-marketplace/mcp
```

对于通过npx启动服务器的客户端:

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

### 土生土长

```bash
brew install budna-marketplace/tap/budna-mcp
```

Homebrew 自动安装 Rust 从源头开始构建.

### 货物

惠璶 [1.88或更新鲜](https://rustup.rs/)。 。 。 .

安装最近发布的发布 :

```bash
cargo install budna-mcp --locked
```

要从本地检出中安装 :

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

### 添加到代码

在 macOS 或 Linux 上:

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

在 Windows PowerShell 上显示:

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

在添加服务器后启动新的 Codex 任务, 然后询问 :

> 利用Budna寻找公共相机列表.

这个 [Codex MCP 文档](https://learn.chatgpt.com/docs/extend/mcp?surface=cli) 覆盖项目范围配置和其他客户端选项.

### 添加到另一个 stdio MCP 客户端

配置返回的绝对路径 `command -v budna-mcp` (或 `(Get-Command budna-mcp).Source` 在Windows上),没有参数:

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

对于JSON-config客户端:

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

## 尽你所能

Budna MCP今天只读. 公共工具在当地没有账户 `budna-mcp` 二进制和在 `https://api.budna.se/mcp`。账户工具仅在您连接您的 Budna 账户并给予它们所需的许可后,在主机账户资源上可用。 账户资源也为每一个公共工具服务,所以一个连接既包括公共市场,也包括你自己的数据.

| 工具 | 访问 | 它会做什么 |
| --- | --- | --- |
| `search_listings` | 公开 | 搜索和过滤公共市场清单 |
| `get_listing` | 公开 | 公开上市 |
| `get_listing_attributes` | 公开 | 获取列表结构化的公共属性 |
| `get_listing_related` | 公开 | 查找与列名有关的公开列名 |
| `get_seller_listings` | 公开 | 列出卖方的公开名单 |
| `browse_listings` | 公开 | 浏览特色上市,最新上市或一个品牌的上市 |
| `get_categories` | 公开 | 浏览分类树 |
| `get_category_filters` | 公开 | 获取分类中的过滤器 |
| `get_filter_options` | 公开 | 获取一个过滤器的选项 |
| `get_brands` | 公开 | 上市品牌及其上市计数,或获得一个品牌 |
| `get_locations` | 公开 | 列出在瑞典或挪威进行过滤的区域和市镇搜索,并列出点数 |
| `get_search_suggestions` | 公开 | 获取部分输入文本的列表和分类建议 |
| `get_public_seller_profile` | 公开 | 获取一个卖家的公众形象 |
| `get_seller_ratings` | 公开 | 获得卖家的评分统计 和他们得到的评分 明星,评论和评分的公众用户名 |
| `get_listing_bid_summary` | 公开 | 得到一个上市的出价和时价,没有投标人的身份 |
| `get_listing_bid_history` | 公开 | 获得上市拍卖轮和出价历史,投标人显示为"投标人1","投标人2"等,如在app. 有了你的账户和投标许可, 你自己的出价显示为你 |
| `get_public_ratings_summary` | 公开 | 获取一个列表的汇总公共评级信号 |
| `get_listing_questions` | 公开 | 通过公共用户名与作者一起阅读列表中的公开问题和聊天 |
| `browse_collections` | 公开 | 浏览收藏,一个销售商的旗下列表:活的或一个销售商的 |
| `get_collection` | 公开 | 获取一个收藏及其列表的一页 |
| `browse_live_streams` | 公开 | 列出现在或即将上台的现场购物流 |
| `get_live_stream` | 公开 | 上市、拍卖会和要来的东西 |
| `get_shipping_rates` | 公开 | 获得包件尺寸和每个承运人的国内发货价格 |
| `get_my_account` | 账户权限 | 读取您的账户ID、 账户类型和显示名称 |
| `get_my_profile` | 配置文件权限 | 读取您的档案、 级别和徽章、 校验、 账号、 订阅和登入步骤 |
| `get_my_achievements` | 配置文件权限 | 读你的成就和进步 |
| `get_my_referral` | 配置文件权限 | 读一下你的转诊密码, 转诊数和你的奖励, 从来没有你提到过谁 |
| `get_my_legal_documents` | 配置文件权限 | 阅读您所接受的每份法律文件的哪个版本,以及是否等待您更新的文件 |
| `list_my_listings` | 列名许可 | 列出自己的列表,包括草稿,包括标题、状态、类型和更新时间 |
| `get_my_listing` | 列名许可 | 读取您列表中包含草稿和预留价格的所有人可见的细节 |
| `list_my_bids` | 投标许可 | 列出您的出价, 包括金额、 时间和状态( 有效、 超标、 胜出或取消) , 或仅列出当前获胜的出价 |
| `list_my_auto_bids` | 投标许可 | 列出您设定的最大价位及其状态的自动出价 |
| `list_my_offers` | 提供许可 | 名单提供您发送或收到的,与对方的公用用户名,金额,反出价,状态,谁最后采取行动并到期 |
| `list_my_second_chance_offers` | 提供许可 | 列出你在拍卖后收到的第二次竞价 |
| `get_my_offer_history` | 提供许可 | 阅读一个提议谈判的每个步骤:谁采取行动、行动以及数额 |
| `list_my_watchlists` | 监视列表权限 | 列出您的监视列表及其姓名和项目统计 |
| `list_my_watchlist_listings` | 监视列表权限 | 列出您监视列表中保存的列表 |
| `list_my_saved_searches` | 监视列表权限 | 列出您保存的搜索内容及其标准、提醒和隐形匹配 |
| `list_my_saved_search_matches` | 监视列表权限 | 列出您保存的搜索匹配列表 |
| `list_my_live_reminders` | 监视列表权限 | 列出您要求被提醒的活流 |
| `list_my_orders` | 命令许可 | 列出您的购买或销售情况与对方的公共用户名、付款、交货和返还状况、载体、追踪号码,以及销售时的付款情况 |
| `get_my_order` | 命令许可 | 详细阅读一次购买或销售:追踪事件、返还、退款、争议状况和发票号码 |
| `list_my_disputes` | 命令许可 | 列出关于您的购买和销售的争议, 与您一方, 原因和地位 |
| `get_my_dispute` | 命令许可 | 阅读一份与双方声明和和解提议有关的争议 |
| `list_my_order_groups` | 命令许可 | 列出你们的合并货物、作为包裹发出的若干订单、其金额、承运人和最后期限 |
| `get_my_order_group` | 命令许可 | 阅读一批货物及其订单、金额、承运人和最后期限 |
| `list_my_notifications` | 通知许可 | 按类型、读取状态和相关列表、顺序、提供或保存的搜索列出通知 |
| `get_my_notification_preferences` | 通知许可 | 读取您的通知设置: 频道、 分类和安静时间 |
| `list_my_ratings` | 评分许可 | 列表收视率,收视率或给出,与对方的公共用户名,明星,评论和上市 |
| `get_my_money_summary` | 付款许可 | 读取每笔货币的金额总额:待付、途中付款、暂扣或余额,付款和退款 |
| `list_my_payment_activity` | 付款许可 | 列出您最新的付款活动, 列出金额、 种类和状况 |
| `list_my_payouts` | 付款许可 | 列出你最近的销售收益 |
| `list_my_debts` | 付款许可 | 列出你欠布德纳的债务,如未支付订单的费用 |
| `get_my_credits` | 付款许可 | 阅读您的优先级并增加信用余额 |
| `get_my_payout_setup` | 付款许可 | 读取您是否设立接受销售收益, 无需银行详细信息 |
| `list_my_conversations` | 信件权限 | 列出您与对方的公共用户名、 最新消息和未读数的对话 |
| `get_my_conversation` | 信件权限 | 在您的谈话中读取信件 |
| `list_my_listing_chats` | 信件权限 | 列出您参与的列表聊天, 包括最新消息和未读数 |
| `search_my_messages` | 信件权限 | 搜索您的消息中的单词或短语 |
| `get_my_seller_insights` | 销售许可 | 阅读视图并保存您超过 7, 30 或 90 天的列表, 您的顶级列表和优先信用 |
| `list_my_boosts` | 销售许可 | 列出您购买的助推器, 包括状态、 价格和日期 |
| `get_my_listing_promotion` | 销售许可 | 读取一个上市的助推,搜索优先级,视频处理状况,以及公司增值税待遇 |
| `get_my_shipping_settings` | 销售许可 | 读取您默认的载体和联运选择 |
| `list_my_showcases` | 销售许可 | 列出您的收藏, 包括草稿 |
| `list_my_live_sessions` | 销售许可 | 列出您出售的物品和收入的活流 |
| `list_my_listing_tags` | 销售许可 | 列表扫描并保存您的存储列表标签 |
| `list_my_following` | 经许可后 | 按公共用户名列出您所跟踪的人 |
| `list_my_followers` | 经许可后 | 按公共用户名列出跟随您的人 |
| `list_my_companies` | 公司许可 | 列出你的公司,你在每个公司的角色和发给你的邀请函 |
| `get_my_company` | 公司许可 | 阅读您的公司之一, 其成员的公用名和发票状态 |

在兼容的 MCP 中 Apps客户端也可以浏览交互式上市卡,并明确要求AI比较2到4个所选上市.

Budna MCP目前无法投标、提供报价、购买、消息、记录视图、更改账户设置或以其他方式改变市场数据.

### 允许您控制

-   当您连接到一个应用程序时, Budna 显示它要求的, 并选择给予哪些权限: **账户** (单位:千美元)`account:read`, (中文(简体) ), **名单** (单位:千美元)`listings:read`, (中文(简体) ), **投标** (单位:千美元)`bids:read`, (中文(简体) ), **提议** (单位:千美元)`offers:read`, (中文(简体) ), **监视列表和保存的搜索** (单位:千美元)`watchlist:read`, (中文(简体) ), **命令** (单位:千美元)`orders:read`, (中文(简体) ), **通知** (单位:千美元)`notifications:read`, (中文(简体) ), **评级** (单位:千美元)`ratings:read`, (中文(简体) ), **付款** (单位:千美元)`payments:read`, (中文(简体) ), **信件** (单位:千美元)`messages:read`, (中文(简体) ), **简介** (单位:千美元)`profile:read`, (中文(简体) ), **销售** (单位:千美元)`selling:read`, (中文(简体) ), **跟踪** (单位:千美元)`following:read`和 **企业** (单位:千美元)`company:read`) (中文(简体) ).
-   账户工具只通过公共用户名称来命名其他买方或卖方的应用程序,并且绝不透露谁在上市。 从不包含地址,联系方式和通知文本;消息文本仅由信件许可共享,争议声明仅由命令许可.
-   在账户下 – Security – 连接到的应用程序中,您可以在任何时候删除一个权限或断开一个应用程序. 取消一个许可立即生效, 包括访问已经持有的应用程序; 恢复它需要再次批准该应用程序 .
-   一个连接最多持续了七天,然后你再批准它.
-   断开连接会停止未来的访问,但无法回顾已经与AI服务共享的信息.

### Budna MCP 要去的地方,我们去

Budna MCP正在向Budna应用软件和网络上所能做的一切发展。 接下来是一些行动,如投标、报价、购买、销售和管理你的名单以及信息。 每一个新能力都会在自己的许可之后到达 每一个应用程序, 敏感的行动,例如投标和购买 将要求您明确确认, 你可以减少或取消访问 在任何时候。 目前还没有采取这些行动.

## 连接您的 Budna 账户

添加 `https://api.budna.se/account/mcp` 作为远程(Streamable HTTP)MCP服务器的AI客户端. 客户端打开您的浏览器以登录到 Budna at `https://connect.budna.se` 并显示它请求的权限;您选择了要授予的权限。 见 [允许您控制](https://npmcn.com/package/%40budna-marketplace/mcp/#readme-permissions-you-control) 用于减少或删除以后的访问.

| 客户端 | 设置 |
| --- | --- |
| 克劳德代码 | `claude mcp add --transport http budna https://api.budna.se/account/mcp`,则 `/mcp` 要认证 |
| 代码 | `codex mcp add budna-account --url https://api.budna.se/account/mcp`,则 `codex mcp login budna-account` |
| 聊天游戏 | 添加自定义连接器到 URL, OAuth 客户端 ID `budna-chatgpt` 并且没有客户秘密 |
| 克洛德(网络和桌面) | 添加自定义连接器到 URL 和 OAuth 客户端 ID `budna-claude` |
| 视觉工作室代码 | 将 URL 添加为 HTTP MCP 服务器 |
| 鹅 | 将 URL 添加为远程扩展 |
| 双子座CLI | 添加 URL 为 `oauth.clientId` 设置为 `budna-gemini-cli` |
| 光标 | 用 OAuth 客户端ID 添加 URL `budna-cursor` |

其他客户尚未被接受。 见 [账户访问](https://npmcn.com/package/%40budna-marketplace/mcp/docs/account-access.md) 用于完整权限模型和每个工具返回的数据.

## 使用非生产环境

将这些值组合在一起,以便 API 请求, 公开上市链接, 和图像保持在同一环境中 :

| 设置 | 目的 |
| --- | --- |
| `BUDNA_API_URL` | Budna API 基址,包括 `/api/v1` 在适用的情况下. |
| `BUDNA_PUBLIC_LISTING_ORIGIN` | 用于返回上市链接的出处 . |
| `BUDNA_IMAGE_ORIGIN` | 用于返回图像 URL 和 App CSP 的出处 . |

远程API URL必须使用 HTTPS; HTTP 只能被接受用于回路开发服务器. 列表和图像值必须是Canonic HTTPS的起源,没有证书,路径,查询,片段,或通配符主机. 二进制不装入 `.env` 文件本身; [`.env.example`](https://npmcn.com/package/%40budna-marketplace/mcp/.env.example) 是参考材料.

例如,为另一个环境注册单独的 Codex 服务器:

```bash
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
```

当客户端可以提供等效环境变量时,会支持它们.

## 互动卡

市场探索器被嵌入到二进制中. 支持 [MCP 磁共振 应用程序扩展](https://modelcontextprotocol.io/extensions/apps/overview) 可以渲染出上市卡,细节,相关/销售上市,以及比较选择. 其他客户端收到相同的文本并结构化的JSON倒置. 见 [扩展支持矩阵](https://modelcontextprotocol.io/extensions/client-matrix) 服务对象.

见 [市场探索指南](https://npmcn.com/package/%40budna-marketplace/mcp/docs/mcp-apps.md) 用于本地HTTP测试,临时隧道安全,隐私和归属行为,UI开发和放行检查.

该项目根据以下规定获得许可证: [MIT 许可证](https://npmcn.com/package/%40budna-marketplace/mcp/LICENSE)。 。 。 .

## 常见问题

### @budna-marketplace/mcp 是什么？

Budna市场和MCP客户账户整合

### 如何安装 @budna-marketplace/mcp？

在项目目录运行 npm install @budna-marketplace/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 budna-mcp，可以用 npx budna-mcp 直接运行。

### @budna-marketplace/mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/budna-marketplace\_\_mcp 是否存在。

### @budna-marketplace/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=14\.14。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @budna-marketplace/mcp 可以商用吗？

@budna-marketplace/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @budna-marketplace/mcp 的下载量有多少？

根据 npm 官方下载统计，@budna-marketplace/mcp 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,463 次，日均约 82 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @budna-marketplace/mcp 还在维护吗？

最新版本 0\.8\.0 发布于 2026/10/31（9 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/10/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。