Getting Started
Go to Nodit!

Nodit for AI - Nodit MCP✨

Suggest Edits

🎉 Now Live — Discover a New Way to Interact with Blockchain Data

AI와 함께 Nodit을 가장 스마트하게 사용하는 방법, Nodit의 공식 MCP Server가 2025년 4월 29일 공개되었습니다.

GitHub - noditlabs/nodit-mcp-server NPM Package

이제 복잡한 코드 구현 없이도 AI가 Nodit API를 사용하여 복잡한 블록체인 데이터를 직접 조회하고, 분석하고, 사용할 수 있습니다. 오픈소스로 공개된 Nodit MCP 서버를 지금 바로 사용해보세요!


What is Nodit MCP(Model Context Protocol)?

What is MCP?

AI 시스템에서 Context란 대형 언어 모델(LLM)과 같은 AI가 현재 상태를 이해하고 합리적인 결정을 내릴 수 있게 해주는 외부 정보를 의미합니다. 예를 들어, 사용자의 과거 대화 이력, 시스템 설정값, 외부 API로부터 가져온 실시간 데이터 등이 모두 Context에 해당합니다. 하지만 전통적인 LLM 아키텍처에서는 모델이 외부 시스템(API, 데이터베이스 등)과 직접 연결되어 정보를 조회하거나 액션을 수행할 수 없었으며, 필요한 모든 Context를 입력 프롬프트에 미리 주입해야 했습니다. 이로 인해 AI가 다룰 수 있는 정보량과 적용 범위에는 명확한 한계가 있었습니다.

이러한 한계를 극복하기 위해 등장한 것이 Model Context Protocol (MCP) 입니다. MCP는 LLM이 실행 중 외부 시스템과 안전하게 통신하면서 필요한 정보를 실시간으로 조회하고 Context를 동적으로 확장할 수 있도록 지원하는 표준 프로토콜입니다. LLM은 MCP가 제공하는 JSON-RPC 기반 인터페이스를 통해 다양한 외부 시스템에 직접 접근하고, 동적으로 Context를 구성하여 보다 풍부하고 정확한 결과를 생성할 수 있습니다.


Nodit MCP: Nodit APIs for LLMs

Nodit MCP는 Nodit이 제공하는 RPC Node, Node API, Web3 Data API, Webhook, Aptos Indexer API 등을 LLM이 직접 탐색하고 호출할 수 있도록 지원하는 MCP Tool입니다. AI 에이전트와 같은 애플리케이션은 Nodit MCP를 통해 제공되는 도구들을 사용하여 Nodit API 목록을 탐색하고, API 사양을 조회하며, 필요한 API를 호출할 수 있습니다. 이렇게 조회된 On-chain 데이터는 AI의 의사결정에 필요한 Context로 활용되어, 더욱 신뢰성 있는 분석과 액션을 가능하게 합니다.


Why Use Nodit MCP?

Nodit은 블록체인 인프라를 추상화하여, 별도의 노드 운영이나 데이터 적재 없이도 멀티체인 데이터에 쉽게 접근할 수 있도록 다양한 기능을 지원해왔습니다. 그러나 API를 연동하여 실제 서비스를 구축하는 과정에서는 여전히 체인별 데이터 특성에 대한 이해, 기본적인 개발 지식, 별도의 데이터 적재 및 관리가 필요한 경우가 많았습니다. 특히 AI 시스템과 블록체인 데이터를 연동하기 위해서는 적재된 데이터를 다시 프롬프트에 주입해야 하는 번거로운 과정이 필요했습니다.

Nodit MCP는 이러한 과정을 한 단계 더 추상화하여, AI와 블록체인 간 연결을 개발자 친화적인 방식으로 간소화합니다. 별도의 연동 코드를 작성하거나 데이터 구조를 일일이 이해할 필요 없이, AI가 직접 Nodit의 API를 탐색하고 호출할 수 있습니다. 이를 통해,

  • AI Agent는 자체적으로 Nodit API를 탐색하고 필요한 데이터를 실시간으로 가져와 다양한 블록체인 기반 의사결정을 수행할 수 있습니다.
  • Web3 개발자는 Nodit API의 상세 구조를 모두 학습하지 않고도, MCP에 연결된 LLM을 통해 필요한 기능의 코드를 자동 생성하거나, 특정 지갑이나 트랜잭션 데이터를 분석하는 시나리오를 빠르게 구현할 수 있습니다.

결과적으로 Nodit MCP는 블록체인 데이터 접근의 진입 장벽을 낮추고, 누구나 쉽게 Web3 기반의 스마트한 애플리케이션을 구축할 수 있도록 지원하는 실용적인 도구입니다.


Key Features

Multichain Blockchain Data Access

AI 모델은 하나의 MCP 인터페이스를 통해 Nodit의 Elastic Node 인프라와 Web3 Data API, Indexer API를 사용하여 Nodit이 지원하는 모든 블록체인 네트워크의 데이터를 조회할 수 있습니다. 모든 API는 LLM 친화적인 구조로 제공되어, 실시간 블록체인 상태, 트랜잭션 이력, 계정 활동 등 다양한 데이터를 추가적인 데이터 파싱이나 변환 없이 바로 활용할 수 있습니다.

AI-Ready API Exploration Tools

Nodit MCP는 AI가 스스로 Nodit API를 탐색하고 호출하는 과정을 처리할 수 있도록 모듈화된 MCP Tools를 제공합니다. Nodit MCP가 제공하는 도구 목록은 다음과 같습니다.

Function Tool Name Description
List API Categories list_nodit_api_categories 사용 가능한 API 카테고리 탐색
List API Operations list_nodit_node_apis, list_nodit_data_apis,
list_nodit_aptos_indexer_api_query_root		 카테고리별 API 목록 조회
Get API Specification get_nodit_api_spec API 세부 사양 조회
Call API call_nodit_api, call_nodit_aptos_indexer_api API 호출 실행

Lightweight Context and Token Efficiency

모든 API 탐색 및 호출은 JSON-RPC 기반 MCP Protocol을 따릅니다. 필요한 정보만 요청하고 필요한 시점에 호출하는 설계 덕분에, LLM의 토큰 소비를 최소화하고 프롬프트 크기를 가볍게 유지할 수 있습니다.

Developer-Friendly Integration

Nodit MCP는 표준 입출력을 지원하는 MCP Server로 구현되어, 별도 복잡한 설정 없이 Local 서버 구동을 통해 Cursor IDE, Claude Desktop, Claude CLI 등에 바로 연동하여 사용할 수 있습니다.


How to Use

Prerequisite: Get Your Nodit API Key

Nodit MCP를 사용하기 위해서는 먼저 Nodit API Key를 발급받아야 합니다. MCP를 통해 호출된 모든 요청은 MCP에 설정된 API Key를 기반으로 인증을 수행하고 사용량이 관리되며, Nodit Console의 Dashboard와 Request Log에서 사용 이력을 확인할 수 있습니다.

API Key는 다음과 같이 확인할 수 있습니다. API Key에 관련된 자세한 내용은 API Key 가이드를 참고해주세요.

  1. Nodit Console에 Sign in 합니다. 계정이 없는 경우 Sign up 링크를 클릭하고 회원가입하여 신규 계정을 생성합니다.
  2. 회원 가입이 완료되면, 자동으로 생성된 'My First Project' 프로젝트의 Overview 페이지로 이동합니다.
  3. Overview 페이지의 상단 API Key 메뉴에서 API Key 값을 복사합니다.

Running Local Nodit MCP Server

🔔

Cursor IDE나 Claude 같은 어플리케이션을 통해 Nodit MCP를 사용하시나요?

Cursor IDE나 Claude 같은 어플리케이션을 통해 Nodit MCP를 등록하고 사용하는 경우, 별도로 로컬 서버 구동을 확인하지 않아도 각 어플리케이션 설정에 npx 옵션을 추가하여 바로 연동할 수 있습니다.

관련 가이드로 바로 이동하여 빠르게 Nodit MCP를 연동해보세요 💪

Nodit API Key가 준비되었다면, 이제 로컬 환경에서 Nodit MCP Server를 구동할 수 있습니다. 서버를 구동하기 전에, 아래 명령어를 입력하여 발급받은 API Key를 환경 변수로 등록해야 합니다. your-api-key부분에 실제 API Key 값을 입력합니다.

export NODIT_API_KEY=your-api-key

Option 1. Using npx (Recommended)

API Key 설정이 완료되면, 아래 npx 명령어를 통해 별도 설치 없이 로컬 환경에서 Nodit MCP Server를 쉽고 빠르게 실행할 수 있습니다. 

npx @noditlabs/nodit-mcp-server@latest

Option 2. Using local build

Github에 공개된 Nodit MCP Server의 최신 코드를 직접 다운로드 받은 뒤 빌드하여 실행하는 방법입니다. 아래 순서에 따라 명령어를 실행합니다. 

# 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

빌드가 완료되면, 다음 명령어로 서버를 실행할 수 있습니다.

node build/index.js

Communicating with the Local Server

Nodit MCP Server는 JSON-RPC 프로토콜을 통한 표준 입출력(stdio)을 지원합니다. 서버가 정상적으로 실행 중이라면, 아래와 같이 직접 JSON-RPC 요청을 전송할 수 있습니다.

Example: List available tools

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

또는 다음과 같이 echo 명령어 pipe를 사용하여 기본 입출력 동작을 확인할 수 있습니다.

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

Example: Call a specific tool

{"method":"tools/call","params":{"name":"list_nodit_api_categories","arguments":{}},"jsonrpc":"2.0","id":1}

// or

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

Connecting to Cursor IDE or Claude Desktop

로컬 환경에서 구동된 Nodit MCP Server를 Cursor IDE나 Claude Desktop에 연동하여 사용할 수 있습니다. 아래와 파일 위치를 참고하여 mcp.json 또는 claude_desktop_config.json 파일의 mcpServers항목 아래 npx를 통해 MCP 서버를 등록하는 설정을 추가한 뒤 IDE 또는 Claude Desktop을 재실행하면 Nodit MCP가 MCP 목록에 추가된 것을 확인할 수 있습니다.

🔔 아래 설정 코드의 **** 부분을 실제 발급받은 Nodit API Key로 교체해야 정상적으로 API를 호출할 수 있습니다.

  • Cursor IDE
    • 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": "****"
      }
    }
  }
}

Connecting to Claude CLI

Nodit MCP Server는 Claude CLI를 통해서도 쉽게 연동할 수 있습니다. 아래 명령어를 터미널에 입력하여 Nodit MCP를 Claude 클라이언트의 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

Tutorials

Nodit MCP Server를 사용할 준비가 완료되셨나요? 쉽게 따라하면서 AI와 만나 더욱 강력해진 Nodit을 바로 활용해볼 수 있는 몇가지 튜토리얼 컨텐츠가 곧 오픈됩니다🔥 순차적으로 공개될 튜토리얼과 함께 알아갈 Nodit MCP의 무한한 가능성을 기대해주세요!

Updated 4 days ago