Nodit MCP 服务器
一个模型上下文协议（MCP）服务器，通过Nodit的Web3基础设施，将人工智能代理和开发者连接到多个网络中结构化、上下文就绪的区块链数据。
 ](https://nodejs.org/)  ](https://smithery.ai/server/@noditlabs/nodit-mcp-server)
概述
Nodit MCP服务器简化了人工智能模型和应用程序与区块链生态系统之间的交互方式。\ 开发者无需处理复杂的节点RPC调用、原始事件日志或特定于链的数据结构，而是可以直接访问经过标准化的、跨链的区块链数据，这些数据以优化的格式适用于人工智能推理和决策。
使用Nodit的MCP，您可以：
- 构建人工智能代理，使其能够 查询、分析并实时处理区块链数据 在EVM兼容网络和非EVM网络之间。
- 开发集成Web3的应用程序 无需具备专门的区块链开发专业知识。
- 利用Nodit的优势 可靠的节点基础设施、Web3数据API以及GraphQL索引服务 通过一个统一的访问层。
- 轻松使用区块链MCP进行开发 本地和远程集成，具体取决于您的工作流程需求。
支持的网络包括以太坊（Ethereum）、Base、Optimism、Arbitrum、Polygon、Aptos、比特币（Bitcoin）、狗狗币（Dogecoin）、波场（TRON）、XRP Ledger（XRPL）、GIWA（Sepolia）等更多网络。
目录
工具列表
Nodit MCP服务器提供了工具，使AI代理能够动态发现、理解和与Nodit的Web3 API和数据基础设施进行交互。这些工具通过将API交互模块化为不同的步骤，最大限度地减少了代币消耗，并保持了一个轻量级的上下文
- 列出API类别的工具
获取可用的高级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的工具\
使用operationId和已验证的参数执行API调用。
- call_nodit_api - call_nodit_aptos_indexer_api
Nodit MCP Server 通过标准的 JSON-RPC over stdio 协议进行通信，遵循模型上下文协议（MCP）的规范。 目前，仅支持基于stdio的服务器-客户端交互通信。
特性/功能
以下是通过Nodit MCP服务器为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链、GIWA（Sepolia） - 非以太坊虚拟机（Non-EVM）：Aptos、比特币、狗狗币、波场（TRON）、XRP Ledger（XRPL）、Sui、Solana
先决条件
- Node.js 18及以上版本
- Nodit API密钥 注册并获取API密钥 Nodit 控制台)
运行本地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通信。\ 以下是向服务器发送基本请求的方法：
示例：列出可用工具
您可以直接输入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 桌面版
在您的（配置中）添加以下设置 .cursor/mcp.json 或者 claude_desktop_config.json：
- 光标
- MacOS： ~/.cursor/mcp.json - Windows（视窗操作系统）： C:\Users\\.cursor\mcp.json
- Claude Desktop（可译为“Claude桌面版”或保持原样，具体取决于上下文是否需要更具体的翻译）
- MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json - Windows： C:\Users\\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服务器与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服务器
如果您正在使用支持远程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（网页版）
如果您使用的是 Claude 企业版、专业版或最大版计划，您可以集成远程 MCP 服务器。
- 前往“设置”>“集成”，点击\[添加自定义集成\]按钮。
- 点击\[添加更多\]按钮以集成新的远程MCP。
- 将上述提供的端点插入以完成设置。
集成完成后，您将在Claude主屏幕上看到“搜索和工具”部分下已添加Nodit MCP。
连接到 Cursor IDE
将Nodit MCP连接到Cursor IDE： 1\. 打开偏好设置 > 光标设置 > MCP 工具。 2\. 点击\[+ 新建 MCP 服务器\]以打开 mcp.json 配置文件。
你也可以直接在以下路径中打开并编辑 mcp.json 文件：
- MacOS（苹果电脑操作系统）:
~/.cursor/mcp.json - Windows：
C:\Users\\.cursor\mcp.json
将以下配置添加到 mcpServers 对象中。如果您已经配置了其他 MCP 服务器，请用逗号分隔每个条目。
{
"mcpServers": {
"nodit": {
"url": "https://mcp.nodit.io/sse?apiKey=INSERT_YOUR_API_KEY"
}
}
}添加完成后，返回光标界面中的MCP工具，并通过切换开关启用nodit MCP。当状态显示为绿色的“9个工具已启用”时，表示连接已完成。
故障排除
在Claude Desktop上通过npx运行MCP时遇到问题
如果你正在将MCP服务器与……一起运行 Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文判断是否需要具体翻译） 或者对于其他依赖于本地 Node.js 安装的工具，您可能会遇到以下问题：
- 安装了多个版本的 Node.js（例如，通过 Homebrew 和包管理器安装）
- 冲突的PATH环境变量
- Claude Desktop 无法识别正确的 Node.js 运行时
按照以下步骤进行验证 Node.js 18及以上版本 在您的系统上已正确安装并被识别。
1. 检查您当前正在使用的 Node.js 版本
在终端中运行以下命令以检查版本：
node --version你应该看到一个以v18或更高版本（例如v18.19.0）开头的版本号。
如果不是，您可能需要安装一个兼容版本或切换到该版本。
\[!提示\] Claude Desktop 可能不会使用与您的终端相同的 Node.js 版本。如果您安装了多个版本（例如，通过 Homebrew、nvm 或直接安装程序安装），它可能会默认使用一个意想不到的版本。 列出所有常见的安装路径： `` # Homebrew installation ls /usr/local/bin/node ls /opt/homebrew/bin/node # nvm installations ls ~/.nvm/versions/node/ # System installation 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 203. 检查Claude Desktop使用的Node.js版本
Claude Desktop 从您的系统环境继承了 PATH。 在你的终端中运行：
which node这显示了当前在您的终端中激活的 Node.js 二进制文件的路径。这是从该终端启动时，Claude 可能使用的路径。
4. 强制Claude Desktop使用正确的Node.js版本
- 如果你正在使用 nvm：
nvm use 18 # Set proper version
nvm alias default 18- 如果你使用的是 Homebrew，请确保它在你的 PATH 中被优先考虑：
export PATH="/opt/homebrew/bin:$PATH" # for Apple Silicon
# or
export PATH="/usr/local/bin:$PATH" # for Intel Macs我们建议采用单一的安装方法（例如，选择nvm或Homebrew中的一个）以避免版本冲突。
5. 重启Claude桌面版
修改后，请重启 Claude Desktop 以确保其加载正确的环境变量和 Node.js 版本。
使用Nodit MCP的示例提示
一旦连接上Nodit MCP，您就可以使用自然语言直接从多个网络查询区块链数据。 以下示例仅展示了众多可能性中的一小部分——请随意超越这些示例，探索您自己的应用场景。
📊 链上活动监控
Summarize the recent activity of 0xabc…def across Ethereum and Arbitrum. Include major transactions, token transfers, and NFT interactions over the past 7 days.What fungible and non-fungible tokens does this wallet hold across Ethereum and Polygon? Include balances and token names.Analyze the risk profile of wallet 0xabc… based on its recent on-chain behavior.🧾 智能合约与交易分析
Analyze how users interacted with the contract at 0xcontract… on Ethereum over the last week.Analyze the last 10 blocks on Arbitrum.🧠 AI代理应用场景
Based on wallet 0xabc…’s holdings, recommend optimal DeFi strategies across Ethereum and Arbitrum.Create a daily summary report for 0xdao… including token balances, inflow/outflow, and governance activity.⚙️ Web3 DApp（去中心化应用）开发
Write TypeScript code using fetch to retrieve all ERC-20 transfers for 0xabc… from Ethereum using Nodit’s Node API.Build a simple dashboard to visualize how assets have moved in recent XRPL transactions.Build a dashboard that aggregates blockchain data across multiple chains using Nodit.范围与限制
Nodit MCP服务器提供结构化上下文，帮助基于大型语言模型（LLM）的代理有效利用Nodit的API。\ 其职责包括：
- 将Nodit API（节点API、Web3数据API）结构化为大型语言模型（LLM）可消费的格式。
- 公开端点详情、输入/输出模式、示例响应以及错误处理指南。
然而，以下是 在MCP（可能指某种控制系统或管理平台）的控制范围之外:
- API的选择可能会因LLM版本（如GPT-4、Claude 3）、提示工程或代理设计的不同而有所差异。
- API响应或错误的解释取决于消费该API的大型语言模型（LLM）的推理能力。
Nodit MCP服务器专注于提供准确且结构化的API上下文，\ 但是确实 不保证 外部大型语言模型（LLM）的最终推理结果或行为。
许可证
这个项目遵循以下许可协议 Apache许可证2.0。\ 请参阅LICENSE文件以了解完整的许可条款。\ 相关法律声明已提供在 通知 文件。
“Nodit”及Nodit标识是Lambda256的商标。\ 未经事先书面许可，禁止使用该名称或标识。
______________________________________________________________________
© Lambda256。版权所有。