@budna-marketplace/mcp

中文文档
0.8.0发布于 2026/10/31MIT构建来源已验证近 30 天下载 2463

Budna市场和MCP客户账户整合

中文使用文档
文档目录14 节
  1. 快开始
  2. 外壳( macOS / Linux)
  3. Power Shell (窗户)
  4. npm / npx 时间轴
  5. 土生土长
  6. 货物
  7. 添加到代码
  8. 添加到另一个 stdio MCP 客户端
  9. 尽你所能
  10. 允许您控制
  11. Budna MCP 要去的地方,我们去
  12. 连接您的 Budna 账户
  13. 使用非生产环境
  14. 互动卡

布德纳 MCP

build crates.io npm MCP Registry Homebrew

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

快开始

外壳( 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

Power Shell (窗户)

运行在 PowerShell 5.1 或更新 :

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

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

npm / npx 时间轴

要求数 节点.js。 。 。 .

npm install --global @budna-marketplace/mcp

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

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

土生土长

brew install budna-marketplace/tap/budna-mcp

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

货物

惠璶 1.88或更新鲜。 。 。 .

安装最近发布的发布 :

cargo install budna-mcp --locked

要从本地检出中安装 :

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

添加到代码

在 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 (或 (Get-Command budna-mcp).Source 在Windows上),没有参数:

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

对于JSON-config客户端:

{
  "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 并显示它请求的权限;您选择了要授予的权限。 见 允许您控制 用于减少或删除以后的访问.

客户端设置
克劳德代码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

其他客户尚未被接受。 见 账户访问 用于完整权限模型和每个工具返回的数据.

使用非生产环境

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

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

远程API URL必须使用 HTTPS; HTTP 只能被接受用于回路开发服务器. 列表和图像值必须是Canonic 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

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

互动卡

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

见 市场探索指南 用于本地HTTP测试,临时隧道安全,隐私和归属行为,UI开发和放行检查.

该项目根据以下规定获得许可证: MIT 许可证。 。 。 .

版本与发布记录

@budna-marketplace/mcp 共发布 10 个版本,首次发布于 2026/10/28;过去 12 个月发布了 10 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.8.0latest2026/10/319 天前
0.7.02026/10/319 天前
0.6.02026/10/309 天前
0.5.02026/10/309 天前
0.4.12026/10/2910 天前
0.4.02026/10/2910 天前

其他发布通道:bootstrap → 0.3.1。

关于 @budna-marketplace/mcp 的常见问题

@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 和提交记录判断。