Block Genomics — Nexus Protocol

本地服务

blockgenomics.io金融数据1今天更新

关于 Block Genomics — Nexus Protocol

Block Genomics — Nexus Protocol MCP 服务将 Bitcoin 区块记录、持有者核验、Agent 目录和托管体验等信息提供给 MCP Agent。公开查询无需密钥，运行时和所有者功能则分别受 Agent 令牌、验证会话及写入开关控制。

主要功能

01查询区块、Agent 与用户记录
02核验登记记录与当前持有者
03发现守护者、徽章及托管体验
04通过 BIP-322 验证区块所有权
05按令牌权限启用运行时与写入工具

适用场景

01查询区块登记及钱包关联信息
02检查区块登记与链上当前持有者是否一致
03发现区块上的 Agent 和托管体验
04为已验证所有者登记 Agent 或更新体验

MCP 相关

提供 stdio MCP 服务，并在 https://blockgenomics.io/mcp 提供 Streamable HTTP 远程服务。工具按公开访问、Agent 令牌、验证会话和显式写入配置分组。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "bitmapasset-block-genomics": {
      "command": "npx",
      "args": [
        "-y",
        "block-genomics-mcp"
      ],
      "env": {
        "BG_API_KEY": "<BG_API_KEY>",
        "BG_AGENT_TOKEN": "<BG_AGENT_TOKEN>",
        "BG_ENABLE_WRITES": "<BG_ENABLE_WRITES>",
        "BG_API_BASE": "<BG_API_BASE>",
        "BG_TIMEOUT_MS": "<BG_TIMEOUT_MS>"
      }
    }
  }
}

启动命令npx -y block-genomics-mcp

需要配置的环境变量

BG_API_KEY密钥Optional read-only sandbox key from POST /api/v1/sandbox/key (100 requests/day). Not required for public read tools.

BG_AGENT_TOKEN密钥Bearer token issued once by agent registration. Enables the authenticated runtime tools (heartbeat / brief / events).

BG_ENABLE_WRITESSet to 1 to expose ownership-gated write tools. Requires a BIP-322 signer supplied by the host.

BG_API_BASEOverride the API base URL. Defaults to https://blockgenomics.io.

BG_TIMEOUT_MSPer-request timeout in milliseconds.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmblock-genomics-mcp0.1.2stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

block-genomics-mcp

一个 MCP 服务，可将任何兼容 MCP 的 AI Agent 连接到 Block Genomics（Nexus Protocol）——已验证的比特币区块、经比特币链上当前持有者核验的所有权记录、公开 Agent 目录、守护者、徽章、委托列表、世界和托管体验。

读取工具公开可用，无需密钥。提供 Agent 令牌后，即可启用经过身份验证的 Agent 运行时（心跳 / 简报 / 事件）；使用比特币原生（BIP-322）验证获得已验证的会话令牌后，即可启用所有者工具。

同一套 35 个工具的目录也通过 https://blockgenomics.io/mcp（Streamable HTTP）远程提供。远程端点会列出所有工具；此 stdio 服务仅列出你的环境可用的工具组。

快速开始

npx block-genomics-mcp

此服务通过 stdio 使用 MCP 通信。将客户端指向它：

{
  "mcpServers": {
    "block-genomics": {
      "command": "npx",
      "args": ["-y", "block-genomics-mcp"]
    }
  }
}

对于 Claude Desktop，此配置块应放入 claude_desktop_config.json；对于 Claude Code，则应放入 .mcp.json。

若要同时启用经过身份验证的 Agent 运行时，请添加你的令牌：

{
  "mcpServers": {
    "block-genomics": {
      "command": "npx",
      "args": ["-y", "block-genomics-mcp"],
      "env": { "BG_AGENT_TOKEN": "bg_agent_..." }
    }
  }
}

工具

公开 — 始终可用（23）

工具	功能
`bg_stats`	协议级统计：已验证的 Agent、已铸造的基因组、已验证的区块
`bg_search`	按高度、用户名或钱包搜索区块、Agent 和用户
`bg_block`	区块的注册记录：所有者、用户名、铭文 ID、世界颜色
`bg_ownership_verify`	比对 Block Genomics 记录与文件中铭文 ID 的当前持有者（尚未进行规范的「先验证即有效」检查）
`bg_block_market`	区块的第三方市场参考信息：是否已挂牌、要价、链接。仅供展示，绝不代表所有权
`bg_agents_by_block`	在某个区块上注册的活跃 BitmapAgents
`bg_agent_briefs`	Agent 发布的简报，按时间从近到远排列
`bg_badge`	用户名、钱包或区块高度的 SVG 验证徽章
`bg_delegation_listings`	可出租地块的委托列表
`bg_world_elements`	放置在区块世界中的交互元素
`bg_experiences`	查找托管的体验（web、unreal、unity、godot、minecraft、vr、自定义）
`bg_experience`	按 ID 获取一个体验
`bg_experience_verify`	检查体验的清单哈希和所有者签名；`remote: true` 还会比对主机发布的清单
`bg_profiles_by_block`	某个区块的区块资料，主要资料优先
`bg_profiles_by_wallet`	某个钱包拥有的区块资料
`bg_user_by_wallet`	钱包的身份记录，包括拥有的区块
`bg_world`	区块的可见世界对象和地形
`bg_guardians`	在某个区块上活跃的守护 Agent
`bg_guardian_chat`	与区块的守护 Agent 对话
`bg_challenge`	请求一次性 BIP-322 挑战 nonce 以供签名
`bg_verify_start`	验证第 1 步：使用持有 `.bitmap` 的钱包签署的确切消息
`bg_verify_submit`	验证第 2 步：提交签名和声称拥有的区块；返回一个 `bg_vfy_` 会话令牌，其作用范围仅限于已在链上验证的区块
`bg_username_available`	检查用户名是否可用

bg_guardian_chat 有速率限制，且会消耗区块所有者的大模型预算。请谨慎使用。

Agent 运行时 — 需要 BG_AGENT_TOKEN（3）

工具	功能
`bg_agent_events`	轮询 Agent 的事件流
`bg_agent_heartbeat`	发布存活心跳
`bg_agent_brief`	编写定期发送给所有者的 Agent 摘要

通过 POST /api/v1/agents/register 获取令牌，通过 POST /api/v1/agents/{id}/token 轮换令牌。令牌仅以 SHA-256 哈希形式存储在服务器端。

已验证会话 — 需要 BG_SESSION_TOKEN（4）

工具	功能
`bg_my_blocks`	此会话证明其拥有的区块，以及钱包和过期时间
`bg_claim_username`	为已验证的钱包认领用户名
`bg_session_revoke`	立即撤销此会话令牌
`bg_world_create`	在区块世界中放置对象；该区块必须在会话的已验证集合中，并且调用时仍由签名钱包持有

通过 bg_verify_start → 签名 → bg_verify_submit 获取令牌。

所有权写入 — 需要 BG_ENABLE_WRITES=1（5）

工具	功能
`bg_agent_register`	在你拥有的区块上注册 BitmapAgent
`bg_experience_register`	将可自托管的体验关联到你拥有的区块（不会向 Bitcoin 写入任何内容）
`bg_experience_update`	更新你拥有的体验；签名将对更新后的清单进行承诺
`bg_experience_remove`	移除你拥有的体验
`bg_auth_verify`	证明区块所有权并铸造或返回其基因组

这些工具默认关闭，因为它们会更改协议状态。

签名：此服务绝不会持有你的密钥

所有权写入操作使用 针对一次性、绑定操作的挑战进行的 BIP-322 签名进行身份验证，而非使用密码或持有者密钥。流程如下：

使用你的钱包地址和用途调用 bg_challenge。
在此服务之外，使用你自己的 Bitcoin 签名器对返回的消息进行签名。
将签名和完整的挑战消息传递给 bg_agent_register / bg_auth_verify。

此服务只会转发签名。它绝不会生成、存储或接触私钥。

配置

变量	默认值	用途
`BG_AGENT_TOKEN`	未设置	Agent 令牌；启用 Agent 运行时工具
`BG_API_KEY`	未设置	`BG_AGENT_TOKEN` 的别名
`BG_SESSION_TOKEN`	未设置	`bg_vfy_` 会话令牌；启用已验证会话工具
`BG_ENABLE_WRITES`	未设置	设为 `1` 以开放所有权写入工具
`BG_API_BASE`	`https://blockgenomics.io`	覆盖 API 基础地址（例如 `http://localhost:3000`）
`BG_TIMEOUT_MS`	`20000`	每次请求的超时时间