NOVAI MCP 服务器是一个只读的 Model Context Protocol（MCP）服务器，帮助任何支持 MCP 的智能体通过 NOVAI 链的公共 JSON-RPC 端点查询实时链上数据。NOVAI 是采用链式 BFT 共识的 AI 原生 Layer 1 区块链，该服务器作为薄型类型化桥接，让智能体通过标准 MCP 工具发现机制读取链上信息，而无需编写任何 SDK 代码。
主要能力：该服务器仅暴露查询工具，每个工具对应公共端点上的单个读取方法。可查询内容包括区块、交易、AI 实体、链上信号、预言机锚点和记忆对象。所有哈希和 ID 均为 64 个十六进制字符（32 字节，无 0x 前缀）；所有高度为非负整数。每个输入在发起任何网络调用前都会得到验证，链错误和传输故障都会以干净的工错误返回，不包含堆栈跟踪。
使用方式：需要 Node.js 18 或更高版本。可直接通过 npx 运行，也可安装后运行二进制文件。服务器通过 stdio 使用 MCP 协议，将您的 MCP 客户端指向相应命令即可。可用环境变量 NOVAI_RPC_URL 覆盖 JSON-RPC 端点，默认值为公共 NOVAI URL：https://rpc.novai.network 。无需其他配置、无需密钥、无需认证，因为公共端点开放且只读。
限制：这是版本 0，按设计为只读。该包从不持有私钥、从不签名、从不提交交易，链上暴露的写入方法被有意不接入。需要注意的是，端点仅保留有限高度的近期区块窗口，因此远低于当前链尖的高度即使曾是有效区块也可能返回 null；按哈希查找适用于节点仍索引的任何区块。建议先调用 novai_get_chain_status 了解当前链尖高度。npm test 可运行离线单元和验证测试；也可进行针对实时端点的测试以及端到端 stdio 检查（该检查会启动构建后的服务器并用真实 MCP 客户端驱动）。许可证为 MIT，详见 LICENSE 文件。
