Bitbadges Builder MCP

BitBadges Builder MCP服务器

## 失望--搬到 bitbadgesjs-sdk 此独立MCP服务器已弃用，不再维护。 MCP生成器工具已折叠到主 bitbadgesjs-sdk 包裹。 改为使用什么： ``bash npm install -g bitbadgesjs-sdk ` SDK公开了相同的MCP服务器以及 builder CLI。请参阅文档： - [Builder CLI命令](https://docs.bitbadges.io/for-developers/cli/builder-commands) - [MCP服务器设置](https://docs.bitbadges.io/for-developers/mcp) - SDK来源： 独立 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系列”

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

环境变量

不需要钱包、助记词或私钥。此服务器仅构建事务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密钥）

构建者（不需要API密钥）

组件（不需要API密钥）

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

知识（不需要API密钥）

查询工具（需要API密钥）

资源

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

技能

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

支持的代币

签名和广播（您的责任）

此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);

看 获取完整的签名文件。

相关工具

本地开发

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

许可证

麻省理工学院