NIX MCP Server - Simplified Version

Provides an MCP server to query NIX blockchain data via JSON queries with dynamic ABI discovery and per-environment routing.

python

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "haiqiubullish-nix-mcp": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "/full/path/to/nix-mcp/main.py"
      ],
      "env": {
        "CLEOS_PATH": "/path/to/cleos",
        "NODEOS_API": "http://localhost:8888 or your Nodeos endpoint",
        "NODEOS_ENV": "dev or overridden per query",
        "RODEOS_API": "http://localhost:8880 or your Rodeos endpoint"
      }
    }
  }
}

You can run a Python-based MCP server that exposes NIX blockchain data through JSON queries and ABI-driven query discovery. It supports dynamic environments, JSON parameter files, and three core tools to list, inspect, and execute queries against contract ABIs.

How to use

You will interact with the MCP server using a client that can call the three core tools to list queries, retrieve ABIs, and execute queries. Start the server locally, then point your client at the local runtime to query various contracts and environments.

How to install

# Prerequisites
- Python 3.11+
- uv (via uvx) for running the server
- Optional: environment access to Rodeos and Nodeos endpoints

# Step 1: Install the MCP server runtime (via UVX flow shown in examples)
# The setup typically initializes dependencies and prepares the local server environment
# If you already have uv installed, you can synchronize:
uv sync

# Step 2: Prepare environment variables (example placeholders)
# Create or edit environment configuration as needed for endpoints

# Step 3: Start the MCP server locally
uv run python main.py

# Optional: use a provided convenience script if available
./run.sh

Configure environment and start server from CLI

You can launch the server using the standard startup flow described below. The server runs a Python process that serves MCP endpoints locally and accepts dynamic environment selection for each query.

# Start via Makefile target if available
make run

# Or start directly using uv with the main module
uv run python main.py

# Or with a startup script if provided
./run.sh

Available tools

list_queries

List all available query actions from the contract ABI and filter by pattern or environment.

get_query_abi

Return the structure and JSON template for a specific query, based on the contract ABI.

query

Execute a NIX query with JSON parameters against a specific contract and environment.

Built by

VeilStrat

AI signals for GTM teams