内容
# Budna MCP
[](https://github.com/budna-marketplace/budna-mcp/actions/workflows/core.yml)
[](https://crates.io/crates/budna-mcp)
使用公共Budna市场数据，适用于任何兼容的MCP客户端。Budna MCP是只读的：它不需要帐户或API密钥，也不能更改市场数据。
## 快速开始
您需要 [Rust 1.88 或更新版本](https://rustup.rs/)。
安装最新发布的版本：
```bash
cargo install budna-mcp --locked
```
从本地checkout安装：
```bash
cargo install --path crates/budna-mcp --locked
```
### 添加到 Codex
在 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`（或 Windows 上的 `(Get-Command budna-mcp).Source`）返回的绝对路径，不带任何参数：
```text
命令：/绝对路径/to/budna-mcp
参数：无
```
适用于 JSON 配置客户端：
```json
{
"mcpServers": {
"budna": {
"command": "/绝对路径/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 和应用程序 CSP 的源。 |
远程 API URL 必须使用 HTTPS；HTTP 仅适用于循环开发服务器。列表和图像值必须是规范的 HTTPS 源，没有凭证、路径、查询、片段或通配符主机。二进制文件本身不会加载 `.env` 文件；[`.env.example`](.env.example) 是参考资料。
例如，注册另一个环境的单独 Codex 服务器：
```bash
codex mcp add budna-nonprod -- /绝对路径/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
```
当您的客户端可以提供它们时，支持等效的环境变量。
## 交互式卡片
市场资源管理器嵌入在二进制文件中；不需要 Node.js 运行时即可使用它。支持 [MCP Apps 扩展](https://modelcontextprotocol.io/extensions/apps/overview) 的客户端可以渲染列表卡片、详细信息、相关/卖家列表和比较选择。其他客户端接收相同的文本和结构化 JSON 回退。请参阅 [扩展支持矩阵](https://modelcontextprotocol.io/extensions/client-matrix) 以获取客户端覆盖。
参阅[市场资源管理器指南](docs/mcp-apps.md)，了解本地 HTTP 测试、临时隧道安全、隐私和属性行为、UI 开发和发布检查。
该项目在 [MIT License](LICENSE) 下获得许可。
