午夜MCP服务器
](https://www.npmjs.com/package/midnight-mcp) ](https://npm-stat.com/charts.html?package=midnight-mcp)   
MCP服务器，允许AI助手访问Midnight区块链——搜索合同、分析代码和探索文档。
该项目通过额外的开发工具扩展了Midnight Network。
需求
- Node.js 20+ （推荐LTS）
检查您的版本： node --version
Using nvm? Click for Claude Desktop setup
如果您使用nvm，Claude Desktop可能看不到您的nvm管理节点。请改用此配置：
{
"mcpServers": {
"midnight": {
"command": "/bin/sh",
"args": [
"-c",
"source ~/.nvm/nvm.sh && nvm use 20 >/dev/null 2>&1 && npx -y midnight-mcp@latest"
]
}
}
}快速开始
克劳德桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"midnight": {
"command": "npx",
"args": ["-y", "midnight-mcp@latest"]
}
}
}配置文件位置：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json - Linux：
~/.config/Claude/claude_desktop_config.json
光标
一键安装：
或手动添加到 .cursor/mcp.json:
{
"mcpServers": {
"midnight": {
"command": "npx",
"args": ["-y", "midnight-mcp@latest"]
}
}
}VS代码副本
添加 .vscode/mcp.json 或使用命令面板： MCP: Add Server → “命令（stdio）”→ npx -y midnight-mcp@latest
帆板运动
添加 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"midnight": {
"command": "npx",
"args": ["-y", "midnight-mcp@latest"]
}
}
}不需要API密钥。 添加配置后重新启动编辑器。
为什么？@latest? 与从不自动更新的缓存npx包不同，@latest确保您在每次重新启动时都能获得新功能和修复。如果从旧配置升级而没有@latest，同时清除npx缓存：rm -rf ~/.npm/_npx
______________________________________________________________________
包含什么
29工具
| 类别 | 工具 | 描述 |
|---|---|---|
| 搜索 | search-compact, search-typescript, search-docs, fetch-docs | 语义搜索+实时文档提取 |
| 分析 | analyze-contract, explain-circuit, extract-contract-structure, compile-contract | 静态分析+实际编译 |
| 仓库 | get-file, list-examples, get-latest-updates | 访问文件和示例 |
| 版本控制 | get-version-info, check-breaking-changes, get-migration-guide, get-file-at-version, compare-syntax, get-latest-syntax | 版本跟踪和迁移 |
| 人工智能一代 | generate-contract, review-contract, document-contract | AI驱动的代码生成 _（需要采样）_ |
| 复合物 | upgrade-check, get-repo-context | 多步骤操作 _（节省50-70%的代币）_ |
| 健康 | health-check, get-status, check-version | 服务器状态和版本检查 |
| 发现 | list-tool-categories, list-category-tools, suggest-tool | 探索可用工具并获得建议 |
所有工具都以前缀 midnight- （例如。， midnight-search-compact).
真实合同汇编
这 midnight-compile-contract 该工具使用托管编译器服务验证Compact代码：
✅ Compilation successful (Compiler v0.29.0) in 2841ms- 快速模式 (
skipZk=true)：语法验证大约需要1-2秒 - 完整模式 (
fullCompile=true)：在约10-30秒内完成ZK电路生成 - 自动回退：如果编译器服务不可用，则返回静态分析
这可以捕获静态分析遗漏的语义错误（密封字段、披露规则、类型不匹配）。
MCP能力
| 功能 | 特性 |
|---|---|
| 工具 | 29工具 listChanged 通知 |
| 资源 | 9个支持订阅的嵌入式资源 |
| 提示 | 5个工作流提示 |
| 日志记录 | 客户端可控制的日志级别 |
| 补全 | 自动完成提示参数 |
| 进展 | 复合工具的实时进度 |
| 采样 | 人工智能发电（当客户支持时） |
9嵌入式资源
离线快速参考：
- 精简语法指南（v0.16-0.21）
- SDK API参考
- OpenZeppelin合同
- 代币组学概述
- 钱包集成
- 常见错误和解决方案
静态分析
extract-contract-structure 编译前发现常见错误：
| 检查 | 严重性 | 描述 |
|---|---|---|
deprecated_ledger_block | P0 | 捕获 ledger { } → use export ledger field: Type; |
invalid_void_type | P0 | 捕获 Void → use [] （空元组） |
invalid_pragma_format | P0 | 抓住老话→ use `>= 0.16 && 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
> **为什么默认使用YAML？** YAML的令牌效率比JSON高出约20-30%，这意味着AI助手可以从工具响应中处理更多的上下文。
### 本地模式
在本地运行所有内容以保护隐私或离线使用：
{ "mcpServers": { "midnight": { "command": "npx", "args": ["-y", "midnight-mcp@latest"], "env": { "MIDNIGHT_LOCAL": "true", "OPENAI_API_KEY": "sk-...", "CHROMA_URL": "http://localhost:8000" } } } }
需要ChromaDB(`docker run -d -p 8000:8000 chromadb/chroma`)和OpenAI API密钥。
### GitHub代币
添加 `"GITHUB_TOKEN": "ghp_..."` 对于更高的GitHub API速率限制（60→5000次请求/小时）。
______________________________________________________________________
## 开发人员设置
git clone https://github.com/Olanetsoft/midnight-mcp.git && cd midnight-mcp npm install && npm run build && npm test
Lint & format
npm run lint # ESLint (typescript-eslint) npm run lint:fix # Auto-fix lint issues npm run format # Prettier
托管的API运行在Cloudflare Workers+Vectorize上。看 [api/README.md](./api/README.md) 了解后端详细信息。
______________________________________________________________________
## 链接
- [午夜文件](https://docs.midnight.network)
- [MCP规范](https://modelcontextprotocol.io)
-
## 许可证
麻省理工学院
## 观星者⭐️
[](https://star-history.com/#Olanetsoft/midnight-mcp&Date)