Midnight + Next.js MCP

Midnight + Next.js 开发 MCP 服务

一个将 Midnight Network 区块链开发工具与 Next.js DevTools 相结合的 Model Context Protocol（MCP）服务，用于构建去中心化应用。

兼容所有支持 MCP 的 AI 助手： Claude、GitHub Copilot、Cursor、Windsurf、Codeium、Continue.dev、Zed、Sourcegraph Cody 等。

🤖 支持的 AI 助手

此 MCP 服务适用于所有支持 Model Context Protocol 的 AI 助手：

AI 助手	平台	配置
Claude	桌面应用、VS Code	原生支持 MCP
GitHub Copilot	VS Code、JetBrains	MCP 扩展
Cursor	IDE	内置支持 MCP
Windsurf	IDE	内置支持 MCP
Codeium	VS Code、JetBrains	MCP 集成
Continue.dev	VS Code、JetBrains	MCP 配置文件
Zed	IDE	支持 MCP
Sourcegraph Cody	VS Code	MCP 扩展

🌙 功能

Midnight Network 工具

合约开发

• midnight_init - 初始化开发上下文
• midnight_compile_contract - 将 Compact 合约编译为 TypeScript/ZK 构件
• midnight_analyze_contract - 对合约进行静态分析
• midnight_deploy_contract - 将合约部署到网络
• midnight_call_contract - 在已部署的合约上执行电路调用
• midnight_scaffold_project - 从模板创建新的 dApp 项目

钱包与代币

• midnight_create_wallet - 使用助记词生成新钱包
• midnight_wallet_state - 获取详细的钱包状态和余额
• midnight_transfer_tokens - 转移 tDUST 代币
• midnight_get_balance - 查询代币余额

网络与查询

• midnight_network_status - 检查网络运行状况（Indexer、Proof Server、Node）
• midnight_get_block - 查询区块链区块
• midnight_get_transaction - 查询交易详情
• midnight_check_versions - 检查 Midnight 软件包更新

文档

• midnight_search_docs - 搜索 Midnight 文档
• midnight-fetch-docs - 获取特定文档页面
• midnight-sync-docs - 从官方仓库同步文档
• midnight-docs-status - 检查文档同步状态
• midnight-list-docs - 列出可用的文档来源

Next.js DevTools

• init - 初始化 Next.js 开发上下文
• nextjs_docs - 搜索 Next.js 文档
• nextjs_index - 发现正在运行的开发服务器
• nextjs_call - 执行运行时诊断工具
• browser_eval - 使用 Playwright 进行浏览器自动化
• upgrade_nextjs_16 - Next.js 16 升级指南
• enable_cache_components - Cache Components 迁移

📦 安装

# Clone the repository
git clone https://github.com/your-username/midnight-nextjs-mcp.git
cd midnight-nextjs-mcp

# Install dependencies
pnpm install

# Build
pnpm build

🚀 使用

使用 npx 快速开始

使用此 MCP 服务最简单的方式是通过 npx，无需安装：

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

配置示例

大多数 AI 助手采用标准化的 MCP 配置格式。以下是各平台的配置示例：

---

通用 MCP 配置

大多数 MCP 客户端都使用这种标准 JSON 格式。将其添加到客户端的 MCP 配置文件中：

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

---

VS Code（GitHub Copilot / Claude 扩展）

将其添加到 VS Code 的 settings.json 或工作区 .vscode/mcp.json 中：

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

或者，针对 Claude 扩展：

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

Claude Desktop（macOS）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

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

Claude Desktop（Windows）

编辑 %APPDATA%\Claude\claude_desktop_config.json：

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

Claude Desktop（Linux）

编辑 ~/.config/Claude/claude_desktop_config.json：

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

Cursor IDE

将其添加到 Cursor MCP 配置中（项目中的 .cursor/mcp.json 或全局设置）：

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

Windsurf / Codeium

将其添加到 Windsurf MCP 设置中：

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

---

Continue.dev（VS Code / JetBrains）

添加到 ~/.continue/config.json 或项目的 .continue/config.json：

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "name": "midnight-nextjs-mcp",
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "midnight-nextjs-mcp@latest"]
        }
      }
    ]
  }
}

---

Zed Editor

添加到 Zed 设置中（Linux 上为 ~/.config/zed/settings.json，macOS 上为 ~/Library/Application Support/Zed/settings.json）：

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

---

Sourcegraph Cody

添加到 Cody MCP 配置中：

{
  "cody.experimental.mcp.servers": {
    "midnight-nextjs-mcp": {
      "command": "npx",
      "args": ["-y", "midnight-nextjs-mcp@latest"]
    }
  }
}

---

JetBrains IDE（IntelliJ、WebStorm 等）

对于支持 MCP 的 JetBrains IDE 中的 AI 助手，请添加到 MCP 配置中：

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

---

使用全局安装

如果你更倾向于全局安装，而不是使用 npx：

npm install -g midnight-nextjs-mcp

然后进行配置：

{
  "mcpServers": {
    "midnight-nextjs-mcp": {
      "type": "stdio",
      "command": "midnight-nextjs-mcp"
    }
  }
}

本地开发 / 从源代码构建

{
  "mcpServers": {
    "midnight-nextjs-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/midnight-nextjs-mcp/dist/index.js"]
    }
  }
}

---

Docker

在 Docker 容器中运行 MCP 服务：

{
  "mcpServers": {
    "midnight-nextjs-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "fractionestate/midnight-nextjs-mcp:latest"]
    }
  }
}

CLI 参数

# Enable both tool categories (default)
npx midnight-nextjs-mcp@latest

# Disable Midnight tools (Next.js only)
npx midnight-nextjs-mcp@latest --no-midnight

# Disable Next.js tools (Midnight only)
npx midnight-nextjs-mcp@latest --no-nextjs

# Check package versions on startup
npx midnight-nextjs-mcp@latest --check-versions

# Set version polling interval (default 24 hours)
npx midnight-nextjs-mcp@latest --poll-interval=12

🏗️ 项目结构

midnight-nextjs-mcp/
├── src/
│   ├── index.ts                    # Server entry point
│   ├── tools/
│   │   ├── index.ts                # Unified tool registry
│   │   ├── midnight/               # Midnight Network tools
│   │   │   ├── init.ts
│   │   │   ├── network-status.ts
│   │   │   ├── get-balance.ts
│   │   │   ├── get-block.ts
│   │   │   ├── get-transaction.ts
│   │   │   ├── search-docs.ts
│   │   │   ├── scaffold-project.ts
│   │   │   ├── compile-contract.ts
│   │   │   └── analyze-contract.ts
│   │   └── nextjs/                 # Next.js DevTools
│   │       ├── init.ts
│   │       ├── nextjs-docs.ts
│   │       ├── nextjs_index.ts
│   │       ├── nextjs_call.ts
│   │       ├── browser-eval.ts
│   │       ├── upgrade-nextjs-16.ts
│   │       └── enable-cache-components.ts
│   ├── providers/                  # Midnight API providers
│   │   ├── index.ts
│   │   ├── indexer.ts              # GraphQL indexer client
│   │   ├── proof-server.ts         # Proof generation client
│   │   └── node.ts                 # Node RPC client
│   ├── resources/                  # MCP resources
│   │   ├── (midnight-compact)/     # Compact language docs
│   │   ├── (midnight-sdk)/         # SDK documentation
│   │   ├── (cache-components)/     # Next.js cache docs
│   │   └── ...
│   ├── prompts/                    # MCP prompts
│   │   ├── create-midnight-contract.ts
│   │   ├── upgrade-nextjs-16.ts
│   │   └── enable-cache-components.ts
│   └── types/                      # TypeScript definitions
│       ├── midnight.ts
│       └── mcp.ts
├── package.json
└── README.md

🔧 配置

环境变量

你可以在配置中向 MCP 服务传递环境变量：

{
  "mcpServers": {
    "midnight-nextjs-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "midnight-nextjs-mcp@latest"],
      "env": {
        "MIDNIGHT_NETWORK": "testnet",
        "MIDNIGHT_INDEXER_URL": "https://indexer.testnet.midnight.network/graphql"
      }
    }
  }
}

可用环境变量

# Midnight Network (optional, defaults to testnet)
MIDNIGHT_NETWORK=testnet
MIDNIGHT_INDEXER_URL=https://indexer.testnet.midnight.network/graphql
MIDNIGHT_PROOF_SERVER_URL=https://proof-server.testnet.midnight.network
MIDNIGHT_NODE_URL=https://rpc.testnet.midnight.network

网络配置

网络	索引器	证明服务
测试网	indexer.testnet.midnight.network	proof-server.testnet.midnight.network
开发网	localhost:8080	localhost:6300

📚 资源

该服务提供以下文档资源：

Midnight 资源

• midnight://compact/overview - Compact 语言简介
• midnight://compact/reference - 完整语法参考
• midnight://sdk/overview - Midnight.js SDK 指南

Next.js 资源

• nextjs-docs://llms-index - 文档索引
• cache-components://overview - Cache Components 指南

🧪 开发

# Watch mode
pnpm dev

# Type check
pnpm typecheck

# Run tests
pnpm test

# Build
pnpm build

📖 文档

• Midnight Network 文档
• Next.js 文档
• MCP 规范
• MCP 服务注册表

特定客户端的 MCP 文档

• Claude Desktop MCP 指南
• VS Code MCP 扩展
• Cursor MCP 文档
• Continue.dev MCP 指南
• Zed MCP 文档

🤝 贡献

欢迎贡献！请先阅读贡献指南。

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE。

---

为 Midnight 和 Next.js 社区倾情打造 ❤️。