STARWARCLOUD STARWAR.AI
返回市场
节点管理服务器

节点管理服务器

作者：noditlabs18 星标更新：2025-11-11
安装使用来源：spider==github.com

项目介绍

技术文档摘要

Nodit MCP Server

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

<a href="https://glama.ai/mcp/servers/@noditlabs/nodit-mcp-server"> <img width="380" height="200" src="https://gips2.baidu.com/it/u=2858891881,1776663201&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Nodit Server MCP server" /> </a>

License Node.js TypeScript smithery badge

概览

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

使用Nodit的MCP，你可以：

  • 构建能够查询、分析并基于实时区块链数据采取行动的AI代理，适用于兼容EVM和非EVM网络。
  • 开发集成Web3的应用程序，无需专门的区块链开发专业知识。
  • 利用Nodit的可靠节点基础设施、Web3数据API和GraphQL索引服务，通过统一的访问层。
  • 根据工作流程需求，在本地和远程集成中轻松开发区块链MCP。

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

目录

工具列表

Nodit MCP Server提供了使AI代理能够动态发现、理解和与Nodit的Web3 API和数据基础设施交互的工具。这些工具通过将API交互模块化为不同的步骤来最小化令牌消耗并保持轻量级上下文：

  • 列出API类别的工具<br> 获取可用的高级API类别列表。

    • list_nodit_api_categories

  • 列出API操作的工具
    获取选定类别中的可用操作（节点API、数据API、Aptos索引器API、Webhook API）。

    • list_nodit_node_apis
    • list_nodit_data_apis
    • list_nodit_aptos_indexer_api_query_root
    • list_nodit_webhook_apis

  • 获取API规范的工具
    获取特定API操作的详细信息（参数、请求/响应模式）。

    • get_nodit_api_spec
    • get_nodit_aptos_indexer_api_spec

  • 调用API的工具
    使用操作ID和验证过的参数执行API调用。

    • call_nodit_api
    • call_nodit_aptos_indexer_api

Nodit MCP Server使用标准的JSON-RPC通过stdio协议进行通信，遵循模型上下文协议（MCP）惯例。 目前仅支持基于stdio的服务器-客户端交互。

功能

以下是通过Nodit MCP Server为AI代理和LLMs提供的关键特性和支持的区块链网络。
详细的API规范和使用指南，请参阅Nodit开发者文档。

  • RPC节点及节点API
    通过Nodit的专业运营基础设施访问区块链节点端点。
    支持实时网络查询、交易提交、智能合约交互等。

  • Web3数据API
    高级API用于访问精心索引的区块链数据。
    包括处理过的数据集，如区块和交易详情、代币转移历史、账户级别的交易摘要以及资产移动详情——这些信息很难直接通过原始RPC调用组装。

  • GraphQL索引器API（仅限Aptos）
    通过GraphQL端点查询详细的Aptos区块链活动。

  • 支持的网络

    • 兼容EVM：以太坊、Arbitrum、Avalanche、Base、Chiliz、Kaia、Optimism、Polygon、BNB Chain、GIWA（Sepolia）
    • 非EVM：Aptos、比特币、狗狗币、TRON、XRPL、Sui、Solana

先决条件

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

运行本地Nodit MCP服务器

使用npx（推荐）

npx @noditlabs/nodit-mcp-server@latest

使用本地构建

# 克隆仓库
git clone --recurse-submodules https://github.com/noditlabs/nodit-mcp-server.git

# 移动到项目目录
cd nodit-mcp-server

# 安装依赖
npm install

# 构建项目
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中添加以下配置：

  • Cursor

    • MacOS: ~/.cursor/mcp.json
    • Windows: C:\Users\<Username>\.cursor\mcp.json

  • Claude Desktop

    • 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 Server使用以下命令：

# 添加Nodit MCP服务器
claude mcp add nodit-mcp-server npx @noditlabs/nodit-mcp-server

# 设置API密钥
export NODIT_API_KEY=your-api-key

# 启动启用Nodit MCP服务器的Claude
claude

集成Nodit远程MCP服务器

如果你正在使用的AI工具支持远程MCP集成，你可以连接到Nodit的远程MCP服务器，而无需运行本地MCP服务器。 这允许你直接在AI环境中使用Nodit MCP特性。

端点

使用以下端点连接到Nodit远程MCP服务器。确保将INSERT_YOUR_API_KEY替换为你的实际Nodit API密钥。

https://mcp.nodit.io/sse?apiKey=INSERT_YOUR_API_KEY

连接到Claude（Web）

如果你使用的是Claude企业版、专业版或Max计划，你可以集成远程MCP服务器。

  1. 前往设置 > 集成，点击[添加自定义集成]按钮。
  2. 点击[添加更多]按钮以集成新的远程MCP。
  3. 插入上述提供的端点以完成设置。

集成完成后，你会看到Nodit MCP已添加到Claude主屏幕上的搜索和工具部分。

连接到Cursor IDE

要将Nodit MCP连接到Cursor IDE： 1. 打开首选项 > Cursor设置 > MCP工具。 2. 点击[+ 新MCP服务器]以打开mcp.json配置文件。

你也可以直接在以下路径打开并编辑mcp.json文件：

  • MacOS: ~/.cursor/mcp.json
  • Windows: C:\Users\<Username>\.cursor\mcp.json

在mcpServers对象中添加以下配置。如果已经配置了其他MCP服务器，请用逗号分隔每个条目。

{
  "mcpServers": {
    "nodit": {
      "url": "https://mcp.nodit.io/sse?apiKey=INSERT_YOUR_API_KEY"
    }
  }
}

添加后，返回Cursor界面中的MCP工具，并通过切换启用nodit MCP。当状态显示“9个工具已启用”的绿色时，连接即已完成。

故障排除

在Claude Desktop上通过npx运行MCP遇到问题

如果你在结合使用Claude Desktop或其他依赖本地Node.js安装的工具时运行MCP服务器，可能会遇到问题，原因可能包括：

  • 多个版本的Node.js已安装（例如，通过Homebrew和包管理器）
  • 冲突的PATH环境
  • Claude Desktop未能识别正确的Node.js运行时

按照以下步骤验证**Node.js 18+**是否已在系统上正确安装和识别。

1. 检查当前激活的Node.js版本

在终端中运行以下命令检查版本：

node --version

你应该看到一个以v18或更高版本开头的版本号（例如，v18.19.0）。

如果没有，你可能需要安装兼容版本或切换到它。

[!TIP] Claude Desktop可能不使用与你的终端相同的Node.js版本。如果你有多个安装（例如，通过Homebrew、nvm或直接安装程序），它可能会默认使用意外的版本。 要列出所有常见的安装路径：

# Homebrew安装
ls /usr/local/bin/node
ls /opt/homebrew/bin/node

# nvm安装
ls ~/.nvm/versions/node/

# 系统安装
ls /usr/bin/node

2. 如需安装或切换到Node.js 18+

如果没有兼容版本，可以使用以下方法之一安装Node.js：

  • 使用Node.js官方安装程序：从nodejs.org下载
  • 使用Homebrew（macOS）：
bashbrew install node@20
  • 使用nvm（推荐用于版本管理）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20
nvm alias default 20

3. 检查Claude Desktop使用的Node.js版本

Claude Desktop继承了系统环境中的PATH。 在终端中运行：

which node

这会显示当前终端中激活的Node.js二进制文件的路径。这是从该终端启动Claude时很可能使用的路径。

4. 强制Claude Desktop使用正确的Node.js版本

  • 如果你使用nvm：
nvm use 18  # 设置正确版本 
nvm alias default 18
  • 如果你使用Homebrew，请确保它在你的PATH中优先：
export PATH="/opt/homebrew/bin:$PATH"  # 对于Apple Silicon
# 或
export PATH="/usr/local/bin:$PATH"     # 对于Intel Macs

我们建议坚持单一安装方法（例如，要么是nvm，要么是Homebrew）以避免版本冲突。

5. 重启Claude Desktop

在做出更改后，重启Claude Desktop以确保它能正确拾取环境变量和Node.js版本。

使用Nodit MCP的示例提示

一旦Nodit MCP连接成功，你可以使用自然语言直接查询来自多个网络的区块链数据。 下面的示例仅展示了众多可能性中的一小部分——请自由探索自己的用例。

📊 链上活动监控

总结0xabc…def在以太坊和Arbitrum上的近期活动。包括过去7天内的主要交易、代币转移和NFT互动。

这个钱包在以太坊和Polygon上持有哪些可替代和不可替代的代币？包括余额和代币名称。

根据其最近的链上行为，分析钱包0xabc…的风险概况。

🧾 智能合约及交易分析

分析用户在过去一周内如何与以太坊上的合约0xcontract…互动。

分析Arbitrum上的最后10个区块。

🧠 AI代理用例

基于钱包0xabc…的持有情况，推荐跨以太坊和Arbitrum的最佳DeFi策略。

为0xdao…创建每日汇总报告，包括代币余额、流入/流出和治理活动。

⚙️ Web3 DApp开发

编写使用fetch检索0xabc…在以太坊上的所有ERC-20转账的TypeScript代码，使用Nodit的节点API。

构建一个简单的仪表板，可视化最近XRPL交易中的资产流动情况。

构建一个聚合来自多个链的区块链数据的仪表板，使用Nodit。

范围与限制

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

  • 将Nodit API（节点API、Web3数据API）结构化为LLM可消费的格式。
  • 暴露端点细节、输入/输出模式、样本响应和错误处理指南。

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

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

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

许可证

本项目根据Apache License 2.0许可。
有关完整的许可条款，请参阅LICENSE文件。
相关的法律通知在NOTICE文件中提供。

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

© Lambda256. 保留所有权利。