GuardMarket

GuardMarket — 基于 MCP 的商务与数据技能

中文 · 125 项技能目录 · 发布版本 · MCP Registry · 集成示例

GuardMarket 为 MCP 客户端提供五种工具，用于发现带版本的技能、查看其架构和价格、设置明确的支出上限后调用技能，以及读取钱包余额和收据。目录介绍了 125 项已实现的商务、库存、CSV、JSON、文本、日期、数学、统计、编码、验证和单位换算技能。

版本 0.3.0 已发布：公开代码仓库、发布版本安装文件和共 130 页的文档网站现已开放。MCPB 已在 io.github.zma-petterzhang/guardmarket 下拥有有效的 MCP Registry 记录，发布于 2026-09-26。这是软件包元数据注册；OpenAI 和 Claude 插件目录的审核是独立步骤。

**此代码仓库提供公开客户端和文档。**技能执行、账户和计费由单独运营的 GuardMarket 后端处理。安装此客户端不会创建后端或钱包。目前尚未提供公开的生产 MCP 端点和 PyPI 页面。静态网站用于提供文档，而非执行请求。随附的示例均为合成数据，不包含任何账户数据。

安装和连接

**桌面应用捆绑包：**从发布版本 v0.3.0下载 guardmarket-mcp-0.3.0.mcpb，并使用 SHA256SUMS 验证。请在支持 MCPB 0.4 及其 uv 运行时的宿主应用中打开。宿主应用负责管理 Python 3.11+；此捆绑包没有外部 Python 依赖项。在安装表单中配置实际的后端 URL。若要匿名发现，请将经过掩码处理的消费者 API 密钥字段留空。仅支持旧版 MCPB 格式的宿主应用应使用下方的 wheel/stdio 安装方式。此捆绑包仍需连接正在运行的后端；它不会安装市场服务端。详情请参阅捆绑包说明。

需要 Python 3.11+。Python 客户端没有运行时依赖项。

python3 -m venv .venv
.venv/bin/python -m pip install "git+https://github.com/zma-petterzhang/[email protected]"
.venv/bin/guardmarket-mcp --version

若要在不使用 Git 的情况下安装，请从发布版本 v0.3.0下载 wheel，使用发布包中的 SHA256SUMS 验证其 SHA-256，然后运行 python -m pip install /path/to/guardmarket_mcp-0.3.0-py3-none-any.whl。生产环境中请固定版本或提交。在 Windows 上使用 .venv\Scripts\python.exe 和 .venv\Scripts\guardmarket-mcp.exe。

将 GUARDMARKET_URL 设置为后端源站，例如，本地实例可使用 http://127.0.0.1:8787。客户端仅接受 HTTPS 源站和数字形式的环回 HTTP 源站。重定向和环境 HTTP 代理均已禁用。

export GUARDMARKET_URL=http://127.0.0.1:8787
.venv/bin/guardmarket-mcp

此命令会在标准输入上等待 MCP 消息；通常由你的 AI 客户端启动。如果后端允许公开发现，则 market.search 和 market.describe 可匿名使用。其他三种工具需要在该后端的账户设置中创建消费者 API 密钥。请通过客户端环境变量（GUARDMARKET_API_KEY）或用户拥有、权限模式为 0600 的常规文件（--key-file /absolute/path/key）提供密钥。--key-file 选项仅适用于 POSIX；环境变量可在 Windows 上使用。切勿将真实密钥放入已提交的配置或聊天消息中。

工具与计费行为

MCP 工具	用途	授权方式
market.search	搜索当前已发布的技能和价格	匿名
market.describe	查看所选版本的架构、示例、效果和价格	匿名
market.invoke	使用 max_price_micros 和 idempotency_key 运行经用户授权的技能	API 密钥
market.wallet	查看可用余额、预留余额和货币	API 密钥
market.receipt	获取已拥有的调用结果和计费状态	API 密钥

请先搜索，再查看确切返回的 skill_id，然后调用。一个货币单位等于 1,000,000 微单位。文档中的 ¥0.01 示例是演示价格，并不代表对任何部署的价格承诺。所选后端会报告其货币、测试／生产模式和实际价格。测试模式使用模拟资金。成功调用会产生费用；待处理或结果不确定的调用可能会保留预留款。结果不确定时，请使用相同的幂等键和完全相同的参数。不要使用新密钥来“重试”。

示例用例：根据给定的税率和折扣率计算购物车总额；验证并规范化产品数据；在导出到电子表格前转义 CSV 公式；比较库存补货阈值；汇总给定数字。这些工具不会获取实时税率、汇率、股价或运费报价。原有的 125 个函数会转换给定数据；第三方技能可能产生外部影响，具体信息由 market.describe 披露。

连接 AI 客户端

示例和经过验证的源代码参考涵盖 Claude Desktop、Claude Code、Qwen Code、Qwen-Agent 和 Codex。可移植的 plugin.json、mcp.json 和 skills/ 套件还包含 Codex 和 Claude 兼容性清单。请先安装客户端，确保启动器的 PATH 中包含 guardmarket-mcp，或者使用可执行文件的绝对路径。

ChatGPT 和 Claude 网页连接器需要已部署的公开 HTTPS MCP 端点及其配置的授权流程。它们无法通过代码库 URL 连接笔记本电脑上的 stdio 命令。GitHub 仓库、文档网站或 llms.txt 不会自动在任何模型中安装工具，也不保证会被编入索引。

开发与发布

python -m unittest discover -s tests -v
python scripts/build_docs.py
python -m pip install build
python -m build
python scripts/build_mcpb.py

CI 会验证 Python 3.11–3.13、重新生成静态网站，并构建 wheel 和 MCPB。推送 v* 标签会创建 GitHub 发布版本，其中包含 wheel、源代码归档、桌面 MCPB 套件和 SHA-256 校验和；但不会发布到 PyPI 或任何 AI 厂商目录。MCPB 构建器使用显式允许列表和确定性 ZIP 元数据，并输出其 fileSha256 以供注册准备使用。GitHub Pages 使用其部署工作流提供 docs/。公开目录元数据是带版本的快照；调用时，所选后端仍是权威来源。

另有一个独立的手动 GitHub Actions 工作流，使用 GitHub OIDC 为 MCP Registry 准备并发布已发布 MCPB 的元数据。该工作流会先验证发布制品及其校验和。v0.3.0 注册运行已成功，其注册记录已激活。该记录指向不可变的 v0.3.0 发布制品；main 上的文档更新不会替换该制品。MCP Registry 发布流程独立于 OpenAI 或 Claude 插件目录审核。

安全 · 隐私与数据处理 · 客户端条款