Nodit MCP 服务器

模型上下文协议 (MCP) 服务器通过 Nodit 的 Web3 基础设施将 AI 代理和开发人员连接到跨多个网络的结构化、上下文就绪的区块链数据。

概述

Nodit MCP Server 简化了 AI 模型和应用程序与区块链生态系统的交互方式。
开发人员无需处理复杂的节点 RPC、原始事件日志或特定于链的数据结构，而是可以以针对 AI 推理和决策优化的格式访问规范化的多链区块链数据。

使用 Nodit 的 MCP，您可以：

构建 AI 代理，用于跨 EVM 兼容网络和非 EVM 网络查询、分析和处理实时区块链数据。
无需专门的区块链开发专业知识即可创建 Web3 集成应用程序。
通过统一访问层利用 Nodit 可靠的节点基础设施、Web3 数据 API 和 GraphQL 索引服务。

支持的网络包括以太坊、Base、Optimism、Arbitrum、Polygon、Aptos、比特币、狗狗币、TRON、XRPL 等。

Nodit MCP 工具的工作原理

Nodit MCP 服务器提供的工具使 AI 代理能够动态地发现、理解并与 Nodit 的 Web3 API 和数据基础架构进行交互。这些工具通过将 API 交互模块化为不同的步骤，最大限度地减少了令牌消耗并维护了轻量级的上下文：

列出 API 类别（ list_nodit_api_categories ）
检索可用的高级 API 类别列表。
列出 API 操作（ list_nodit_node_apis 、 list_nodit_data_apis 、 list_nodit_aptos_indexer_api_query_root ）
获取选定类别中的可用操作（节点 API、数据 API、Aptos 索引器 API）。
获取 API 规范（ get_nodit_api_spec ）
获取特定 API 操作的详细信息（参数、请求/响应模式）。
调用 API（ call_nodit_api ， call_nodit_aptos_indexer_api ）
使用 operationId 和验证的参数执行 API 调用。

Nodit MCP 服务器使用基于 stdio 协议的标准 JSON-RPC 进行通信，遵循模型上下文协议 (MCP) 规范。目前，服务器与客户端之间的交互仅支持基于 stdio 的通信。

特征

以下是通过 Nodit MCP Server 为 AI 代理和 LLM 提供的主要功能和支持的区块链网络。
详细的API规范和使用指南请参考Nodit开发者文档。

RPC 节点和节点 API
通过 Nodit 专业运营的基础设施访问区块链节点端点。
支持实时网络查询、交易提交、智能合约交互等。
Web3 数据 API
用于访问精心索引的区块链数据的高级 API。
包括已处理的数据集，例如区块和交易详细信息、代币转移历史记录、账户级交易摘要和资产流动详细信息——这些信息很难通过原始 RPC 调用直接收集。
GraphQL 索引器 API（仅限 Aptos）
通过 GraphQL 端点查询详细的 Aptos 区块链活动。
支持的网络
- EVM 兼容：Ethereum、Arbitrum、Avalanche、Base、Kaia、Optimism、Polygon
- 非 EVM：Aptos、比特币、狗狗币、TRON、XRPL

先决条件

Node.js 18+
Nodit API 密钥（在Nodit 控制台注册并获取 API 密钥）

运行本地 Nodit MCP 服务器

使用 npx（推荐）

npx @noditlabs/nodit-mcp-server@latest

使用本地构建

# Clone the repository
git clone --recurse-submodules https://github.com/noditlabs/nodit-mcp-server.git

# Move into the project directory
cd nodit-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

开始之前，请设置您的 Nodit API 密钥：

export NODIT_API_KEY=your-api-key

然后启动服务器：

node build/index.js

与本地服务器通信

一旦 Nodit MCP 服务器在本地运行，您就可以使用JSON-RPC 通过 stdio与其通信。
以下是向服务器发送基本请求的方法：

示例：列出可用的工具

您可以直接输入 JSON-RPC 有效负载：

{"method":"tools/list","params":{},"jsonrpc":"2.0","id":1}

或者，您可以使用echo命令来传输请求：

echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":1}' | node build/index.js

示例：调用特定工具（list_nodit_api_categories）

echo '{"method":"tools/call","params":{"name":"list_nodit_api_categories","arguments":{}},"jsonrpc":"2.0","id":1}' | node build/index.js

一体化

连接到 Cursor IDE 或 Claude Desktop

将以下配置添加到您的.cursor/mcp.json或claude_desktop_config.json ：

光标
- MacOS： ~/.cursor/mcp.json
- Windows： C:\Users\<Username>\.cursor\mcp.json
克劳德桌面
- MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows： C:\Users\<Username>\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nodit": {
      "command": "npx",
      "args": ["@noditlabs/nodit-mcp-server@latest"],
      "env": {
        "NODIT_API_KEY": "****"
      }
    }
  }
}

🔔重要
将****替换为您的实际 Nodit API 密钥。
如果 API 密钥配置不正确，API 请求将因身份验证错误而失败。

连接到 Claude CLI

您还可以直接使用 Nodit MCP Server 和 Claude CLI 进行快速设置。

使用以下命令添加 Nodit MCP 服务器：

# Add the Nodit MCP server
claude mcp add nodit-mcp-server npx @noditlabs/nodit-mcp-server

# Set API Key
export NODIT_API_KEY=your-api-key

# Start Claude with the Nodit MCP server enabled
claude

范围和限制

Nodit MCP 服务器提供结构化上下文，帮助基于 LLM 的代理有效地利用 Nodit 的 API。
其职责包括：

以 LLM 可使用的格式构建 Nodit API（节点 API、Web3 数据 API）。
公开端点详细信息、输入/输出模式、示例响应和错误处理指南。

然而，以下情况不在 MCP 的控制范围内：

API 选择可能因 LLM 版本（例如 GPT-4、Claude 3）、提示工程或代理设计而异。
API 响应或错误的解释取决于使用 LLM 的推理能力。

Nodit MCP Server 专注于提供准确且结构化的 API 上下文，
但不保证外部 LLM 的最终推理结果或行为。

执照

该项目采用Apache License 2.0许可。
请参阅 LICENSE 文件以了解完整的许可条款。
相关法律声明在NOTICE文件中提供。

“Nodit”和Nodit标志是Lambda256的商标。
未经事先书面许可，禁止使用该名称或徽标。

Nodit MCP Server

Integrations