Midnight + Next.js Development

You can run the Midnight + Next.js Development MCP Server to combine Midnight Network blockchain development tools with Next.js DevTools, enabling you to build and test decentralized apps with integrated MCP support across compatible AI assistants.

How to use

You will interact with the MCP server through your preferred MCP client. Start by choosing a local or remote runtime configuration, then connect your client to the Midnight Next.js MCP Server to access Midnight tools and Next.js DevTools in a unified workflow. Use the same MCP interface you rely on for other servers to execute contract operations, wallet actions, network queries, and Next.js diagnostics.

How to install

# Install the MCP server (example using a local npm global install)
npm install -g midnight-nextjs-mcp

# Or run via npx without global install
npx -y midnight-nextjs-mcp@latest

# Optional: verify version
midnight-nextjs-mcp --check-versions

Configuration and usage notes

Configure your MCP client to connect to the Midnight Next.js MCP Server using one of the standard MCP configuration patterns shown in the examples. You can run the server directly with npx, install it globally, or use a Docker container. Ensure you provide any required environment variables if your setup relies on specific Midnight Network endpoints.

Troubleshooting and tips

If you encounter connection issues, confirm that the MCP server command is accessible from your shell and that the correct arguments are supplied. Check that your environment variables, if used, point to valid Midnight Network endpoints and that the server has network access to the indexer, proof server, and node endpoints.

Notes on tools and endpoints

The MCP server exposes a range of tools for Midnight Network development and Next.js DevTools. You can invoke contract lifecycle operations, wallet actions, network queries, and Next.js diagnostics through your MCP client. Each tool is exposed as a named function that you can call from your development environment.

Security considerations

Keep your MCP connections secure by using trusted MCP clients and ensuring any exposed endpoints are protected. When using environment variables for sensitive information, avoid committing them to public configuration files and prefer runtime secrets management where possible.

Available tools

midnight_init

Initialize development context for Midnight tools within the MCP server.

midnight_compile_contract

Compile Compact contracts into TypeScript and zero-knowledge artifacts.

midnight_analyze_contract

Perform static analysis on contracts to identify issues before deployment.

midnight_deploy_contract

Deploy compiled contracts to the Midnight network.

midnight_call_contract

Execute circuit calls against deployed contracts.

midnight_scaffold_project

Create a new decentralized app project from templates.

midnight_create_wallet

Generate a new wallet with a seed phrase for testing and deployment.

midnight_wallet_state

Query wallet state and balances.

midnight_transfer_tokens

Transfer tDUST tokens between wallets.

midnight_get_balance

Query token balances.

midnight_network_status

Check network health across the indexer, proof server, and node.

midnight_get_block

Query blockchain blocks.

midnight_get_transaction

Query transaction details.

midnight_check_versions

Check for updates to Midnight packages.

midnight_search_docs

Search Midnight documentation.

midnight-fetch-docs

Fetch specific documentation pages.

midnight-sync-docs

Sync documentation from the official repository.

midnight_docs-status

Check documentation synchronization status.

midnight-list-docs

List available documentation sources.

init

Initialize Next.js development context.

nextjs_docs

Search Next.js documentation.

nextjs_index

Discover running Next.js dev servers.

nextjs_call

Execute runtime diagnostic tools for Next.js.

browser_eval

Automate browser tasks with Playwright for diagnostics.

upgrade_nextjs_16

Upgrade guidance for Next.js 16.

enable_cache_components

Migration aid to enable Cache Components in Next.js.