Midnight + Next.js MCP Server

Unified MCP server that gives AI assistants access to Midnight blockchain and Next.js development—combining Compact contract analysis, turbo monorepo scaffolding, and full-stack dApp development in one package.

Requirements

• Node.js 20+ (LTS recommended)

Check your version: node --version

{
  "mcpServers": {
    "midnight-nextjs": {
      "command": "/bin/sh",
      "args": [
        "-c",
        "source ~/.nvm/nvm.sh && nvm use 20 >/dev/null 2>&1 && npx -y midnight-nextjs-mcp@latest"
      ]
    }
  }
}

Quick Start

VS Code with GitHub Copilot (MCP Registry)

The easiest way to install! Open VS Code and:

1. Open the Extensions panel (Ctrl+Shift+X / Cmd+Shift+X)
2. Click the filter icon and select MCP Registry
3. Search for midnight-nextjs-mcp
4. Click Install

Or manually add to .vscode/mcp.json:

{
  "servers": {
    "midnight-nextjs-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "midnight-nextjs-mcp@latest"]
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "midnight-nextjs": {
      "command": "npx",
      "args": ["-y", "midnight-nextjs-mcp@latest"]
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Cursor

One-click install:

Or manually add to .cursor/mcp.json:

{
  "mcpServers": {
    "midnight-nextjs": {
      "command": "npx",
      "args": ["-y", "midnight-nextjs-mcp@latest"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "midnight-nextjs": {
      "command": "npx",
      "args": ["-y", "midnight-nextjs-mcp@latest"]
    }
  }
}

No API keys required. Restart your editor after adding the config.

Why @latest? Unlike cached npx packages that never auto-update, @latest ensures you get new features and fixes on each restart. If upgrading from an older config without @latest, also clear your npx cache: rm -rf ~/.npm/_npx

What's Included

29 Midnight Tools + 7 Next.js Tools

Midnight tools are prefixed with midnight- (e.g., midnight-search-compact), Next.js tools with nextjs-.

📍 Listed on GitHub MCP Registry: Install directly in VS Code via Extensions → MCP Registry → search "midnight"

Next.js DevTools (Bundled)

This server bundles next-devtools-mcp (v0.3.9+) for unified development:

When starting work on a Next.js project, ALWAYS call the `nextjs-init` tool from
midnight-nextjs-mcp FIRST to set up proper context and establish documentation
requirements. Do this automatically without being asked.

When working with Next.js, always call the init tool from midnight-nextjs-mcp
at the start of the session to establish proper context and documentation requirements.

Next.js MCP Resources (Proxied)

Resources from next-devtools-mcp are automatically available:

MCP Capabilities

35 Embedded Resources

Quick references available offline:

• Compact syntax guide (v0.16-0.18)
• SDK API reference
• OpenZeppelin contracts
• Tokenomics overview
• Wallet integration
• Common errors & solutions
• Next.js integration patterns
• Turbo monorepo configuration
• Cache Components guide
• Next.js 16 migration guide

Static Analysis

extract-contract-structure catches common mistakes before compilation:

9 Prompts

Midnight Prompts:

• midnight:create-contract — Generate new contracts
• midnight:review-contract — Security and code review
• midnight:explain-concept — Learn Midnight concepts
• midnight:compare-approaches — Compare implementation patterns
• midnight:debug-contract — Troubleshoot issues
• midnight:nextjs-dapp — Scaffold Midnight + Next.js turbo monorepo

Next.js Prompts:

• nextjs:upgrade-to-16 — Guide for upgrading to Next.js 16
• nextjs:enable-cache-components — Cache Components migration workflow
• nextjs:runtime-diagnostics — Diagnose runtime issues in Next.js 16+

GitHub MCP Registry

✅ This server is listed on the official GitHub MCP Registry!

One-Click Install (VS Code + Copilot)

1. Open VS Code Extensions panel (Ctrl+Shift+X / Cmd+Shift+X)
2. Click the filter icon → select MCP Registry
3. Search for midnight-nextjs-mcp
4. Click Install

Registry Details

Verify Registration

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=midnight-nextjs-mcp"

Indexed Repositories

The API indexes 39 Midnight repositories:

Advanced Configuration

HTTP Mode

Run as an HTTP server for web integrations or remote deployment:

# Start HTTP server on port 3000
npx midnight-nextjs-mcp --http --port 3000

Endpoints:

• /health - Health check
• /mcp - Streamable HTTP (MCP protocol)
• /sse - Server-Sent Events

CLI Options

npx midnight-nextjs-mcp --help

Options:
  --stdio          Use stdio transport (default, for Claude Desktop)
  --http           Use HTTP transport with SSE support
  --port <number>  HTTP port (default: 3000)
  --json           Output in JSON (default: YAML for better LLM efficiency)
  --github-token   GitHub token (overrides GITHUB_TOKEN env var)
  -h, --help       Show help
  -v, --version    Show version

Why YAML by default? YAML is ~20-30% more token-efficient than JSON, which means AI assistants can process more context from tool responses.

Local Mode

Run everything locally for privacy or offline use:

{
  "mcpServers": {
    "midnight-nextjs": {
      "command": "npx",
      "args": ["-y", "midnight-nextjs-mcp@latest"],
      "env": {
        "MIDNIGHT_LOCAL": "true",
        "OPENAI_API_KEY": "sk-...",
        "CHROMA_URL": "http://localhost:8000"
      }
    }
  }
}

Requires ChromaDB (docker run -d -p 8000:8000 chromadb/chroma) and OpenAI API key.

GitHub Token

Add "GITHUB_TOKEN": "ghp_..." for higher GitHub API rate limits (60 → 5000 requests/hour).

Developer Setup

git clone https://github.com/FractionEstate/midnight-nextjs-mcp.git && cd midnight-nextjs-mcp
npm install && npm run build && npm test

The hosted API runs on Cloudflare Workers + Vectorize. See api/README.md for backend details.

Links

• Midnight Docs
• MCP Spec
• Midnight GitHub
• nextjs devtools

License

MIT

Thanks to all Stargazers ⭐️