AI导哈

BitBadges构建工具

BitBadges构建工具（MCP服务器）用于通过AI构建、审核和查询BitBadges集合，适用于各种MCP兼容客户端。

  • by BitBadges
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 BitBadges/bitbadges-builder-mcp

使用说明

BitBadges Builder MCP服务器

失望--搬到 bitbadgesjs-sdk

此独立MCP服务器已弃用，不再维护。 MCP生成器工具已折叠到主 bitbadgesjs-sdk 包裹。

改为使用什么：

npm install -g bitbadgesjs-sdk

SDK公开了相同的MCP服务器以及 builder CLI。请参阅文档：

独立 bitbadges-builder-mcp npm包和此仓库仅保留用于历史引用和重定向目的。不要与他们作对—— audit_collection 相关工具已被替换为 review_collection 在SDK中，不会在此处发布进一步的更新。

MCP（模型上下文协议）服务器，用于通过人工智能构建、审核和查询BitBadges集合。可与Claude Desktop、Claude Code、Cursor和任何兼容MCP的客户端配合使用。

此MCP服务器不签署或广播事务。 它构建交易JSON，您的应用程序使用您自己的钱包/签名者对其进行签名和广播。

快速启动（已停用-使用 bitbadgesjs-sdk 相反）

1.安装

# DEPRECATED: do not use
# npm install -g bitbadges-builder-mcp

# Use this instead:
npm install -g bitbadgesjs-sdk

2.配置您的MCP客户端

克劳德桌面版 (~/.config/claude/config.json):

{
  "mcpServers": {
    "bitbadges-builder": {
      "command": "npx",
      "args": ["bitbadges-builder-mcp"],
      "env": {
        "BITBADGES_API_KEY": "your-api-key-here"
      }
    }
  }
}

克劳德代码 (.mcp.json 在项目根目录中）：

{
  "mcpServers": {
    "bitbadges-builder": {
      "command": "npx",
      "args": ["bitbadges-builder-mcp"],
      "env": {
        "BITBADGES_API_KEY": "your-api-key-here"
      }
    }
  }
}

光标 （设置>MCP服务器>添加）：

{
  "command": "npx",
  "args": ["bitbadges-builder-mcp"],
  "env": {
    "BITBADGES_API_KEY": "your-api-key-here"
  }
}

3.获取API密钥

获取您的免费API密钥： https://bitbadges.io/developer

API键启用查询工具（请参见下文）。生成器、验证和知识工具在没有API密钥的情况下工作。

4.开始建设

“以5 BADGE造币价创建1000个供应NFT系列”

“建立一个USDC稳定币金库，每天提款限额为100”

“向我解释123系列”

“审核此集合的安全风险”

环境变量

变量 必填 描述
BITBADGES_API_KEY 对于查询工具 API密钥来自https://bitbadges.io/developer

不需要钱包、助记词或私钥。此服务器仅构建事务JSON——您的应用程序处理签名和广播。

运作原理

You describe what you want
    ↓
MCP builds transaction JSON (MsgUniversalUpdateCollection, MsgTransferTokens, etc.)
    ↓
review_collection catches security issues
    ↓
validate_transaction checks JSON format
    ↓
You sign with your wallet (MetaMask, Keplr, SDK, etc.) and broadcast

可用工具

验证和分析（不需要API密钥）

工具 说明
validate_transaction 根据关键规则验证事务JSON
audit_collection 安全风险、设计缺陷、供应膨胀向量的审计
explain_collection 为集合生成人类可读的标记解释

构建者（不需要API密钥）

工具 说明
build_token 通用令牌生成器——来自设计轴的任何集合类型
build_smart_token IBC支持的智能代币（稳定币、包裹资产）
build_fungible_token ERC-20风格的可替换代币
build_nft_collection 具有minting配置的NFT集合
build_address_list 链上地址列表（经理添加/删除）
build_claim 为API构建声明JSON（代码-门控、密码-门控、白名单-门控、打开）

组件（不需要API密钥）

工具 说明
generate_backing_address 从denom计算确定性IBC支持地址
generate_approval 按类型构建审批结构
generate_permissions 构建权限预设
generate_alias_path 为流动性池构建别名路径

实用程序（不需要API密钥）

工具 说明
convert_address 在ETH（0x）和BitBadges（bb1）格式之间转换
validate_address 检查地址是否有效并检测链类型
lookup_token_info 获取令牌符号、标记、小数、支持地址
get_current_timestamp 使用可选偏移量获取当前时间

知识（不需要API密钥）

工具 说明
get_skill_instructions 获取特定技能的详细说明
search_knowledge_base 搜索文档、学习、食谱、错误模式
diagnose_error 诊断交易错误并提出修复建议
fetch_docs 从docs.bitbadges.io获取实时文档

查询工具（需要API密钥）

工具 说明
query_collection 使用字段筛选获取集合详细信息
query_balance 检查地址的令牌余额
simulate_transaction 有效性和气体估算的模拟交易
verify_ownership 验证地址是否符合AND/OR/NOT所有权要求
search 搜索集合、帐户和令牌
search_plugins 搜索索赔插件或按ID获取
analyze_collection 查询并生成结构化集合分析
build_transfer 自动查询收集和构建MsgTransferTokens
build_dynamic_store 构建动态存储操作（创建、更新、设置值）
query_dynamic_store 查询动态存储值和元数据

资源

MCP服务器公开了这些资源，客户端可以读取这些资源以获取上下文：

资源URI 描述
bitbadges://rules/critical 构建交易的关键规则
bitbadges://tokens/registry 令牌注册表（符号、符号、小数）
bitbadges://skills/all 所有技能说明
bitbadges://docs/concepts 概念文件
bitbadges://docs/examples 交易和模式示例
bitbadges://recipes/all 代码配方和决策矩阵
bitbadges://learnings/all 已知的陷阱、提示和发现
bitbadges://errors/patterns 错误模式和诊断
bitbadges://workflows/all 分步工作流程链
bitbadges://schema/token-builder 令牌生成器架构参考
bitbadges://docs/frontend 参考前端模式

技能

技能是通过按需加载的详细指令集 get_skill_instructions(skillId):

技能ID 描述
smart-token IBC支持的1:1支持的智能代币
fungible-token ERC-20风格的可替换代币
nft-collection NFT系列设计和铸造
subscription 依赖时间的订阅令牌
bb-402 令牌门控API访问（HTTP 402模式）
ai-criteria-gate AI代理作为标准验证器
minting 铸币策略（公众、经理、定价）
custom-2fa 自定义2FA要求
immutability 锁定权限和不变性模式
liquidity-pools 可交换代币和交易
payment-protocol 支付和定价机制
verified 已验证的凭证门
tradable 市场交易配置
address-list 链上地址列表集合

支持的代币

符号 IBC数字 小数
BADGE ubadge（宇宙）/abadge（EVM） 9/18
美元 伊拉克第纳尔/F082B65… 6
原子 ibc/A4DB47… 6
OSMO ibc/ED07A3… 6

签名和广播（您的责任）

此MCP服务器返回未签名的事务JSON。要在链上提交：

浏览器（类似于MetaMask的EVM钱包）：

  • 使用ethers.js/viem调用带有事务数据的EVM预编译

浏览器（类似Keplr的Cosmos钱包）：

  • 使用Keplr signDirect 使用交易的SignDoc

服务器端（SDK）：

import { GenericEvmAdapter, GenericCosmosAdapter } from 'bitbadgesjs-sdk';

// EVM path (recommended for server-side)
const adapter = GenericEvmAdapter.fromPrivateKey(key, 'https://evm-rpc.bitbadges.io');

// Cosmos path
const adapter = GenericCosmosAdapter.fromPrivateKey(key, 'bitbadges_50024-1');

// Sign and broadcast
const result = await adapter.signAndBroadcast(messages, fee, memo);

看 BitBadges SDK文档 获取完整的签名文件。

相关工具

工具 安装 说明
BitBadges MCP （这个） npm i -g bitbadges-builder-mcp 人工智能支持的集合构建器、审计员和解释者
BitBadges SDK npm i bitbadgesjs-sdk 用于API、签名、地址转换的TypeScript SDK
BitBadges API https://bitbadges.io/developer 用于查询集合、余额、所有权的REST API
BitBadges文档 https://docs.bitbadges.io 完整文档
BitBadges浏览器 https://explorer.bitbadges.io 链上浏览器

本地开发

git clone https://github.com/bitbadges/bitbadges-builder-mcp.git
cd bitbadges-builder-mcp
npm install
npm run build
npm run dev    # Run with tsx (hot reload)
npm test       # Run tests

许可证

麻省理工学院

相关 MCP