Midnight Nextjs MCP

Midnight+Next.js开发MCP服务器

一个模型上下文协议（MCP）服务器，将Midnight Network区块链开发工具与Next.js DevTools相结合，用于构建去中心化应用程序。

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

🤖 支持的AI助手

此MCP服务器可与支持模型上下文协议的任何AI助手配合使用：

🌙 特性

午夜网络工具

合同开发

• midnight_init -初始化开发上下文
• midnight_compile_contract -将Compact合约编译为Types/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 -检查网络健康状况（索引器、验证服务器、节点）
• midnight_get_block -查询区块链块
• midnight_get_transaction -查询交易明细
• midnight_check_versions -查看Midnight套餐更新

文档

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

Next.js工具

• init -初始化Next.js开发上下文
• nextjs_docs -搜索Next.js文档
• nextjs_index -发现正在运行的开发服务器
• nextjs_call -执行运行时诊断工具
• browser_eval -使用Playwright实现浏览器自动化
• upgrade_nextjs_16 -Next.js 16升级指南
• enable_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"]
    }
  }
}

配置示例

MCP配置格式在大多数AI助手中都是标准化的。以下是特定平台的示例：

______________________________________________________________________

通用MCP配置

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

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

______________________________________________________________________

VS代码（GitHub复制品/Claude扩展）

添加到您的VS代码 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"]
    }
  }
}

克劳德桌面（macOS）

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

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

克劳德桌面（Windows）

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

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

克劳德桌面（Linux）

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

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

光标IDE

添加到光标MCP配置(.cursor/mcp.json 在项目或全局设置中）：

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

风帆/Codeium

添加到您的Windsurf MCP设置中：

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

______________________________________________________________________

Continue.dev（VS代码/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编辑

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

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

______________________________________________________________________

源代码图科迪

添加到您的Cody MCP配置中：

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

______________________________________________________________________

JetBrains集成开发环境（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容器中运行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

网络配置

📚 资源

服务器公开文档资源：

午夜资源

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

Next.js资源

• nextjs-docs://llms-index -文件索引
• cache-components://overview -缓存组件指南

🧪 发展

# Watch mode
pnpm dev

# Type check
pnpm typecheck

# Run tests
pnpm test

# Build
pnpm build

📖 文档

• 午夜网络文档
• Next.js文档
• MCP规范
• MCP服务器注册表

客户特定MCP文件

• 克劳德桌面MCP指南
• VS代码MCP扩展
• 光标MCP文档
• Continue.dev MCP指南
• Zed MCP文件

🤝 贡献

欢迎投稿！请先阅读投稿指南。

📄 许可证

MIT许可证-请参阅 许可证 了解详情。

______________________________________________________________________

建于❤️ Midnight和Next.js社区。