布德纳 MCP
从任何兼容的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_URL | Budna 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 许可证。 。 。 .