Zk Kit MCP

zk工具包mcp

MCP服务器 ZK套件，以太坊基金会PSE的零知识工具包。 为LLM提供跨TypeScript、Circom、Solidity、Noir和Rust的约30个包的结构化访问。

工具

发现与导航

• list_packages -列出和搜索包。按关键字、语言或类别筛选。
• get_ecosystem_overview -按语言和类别分组的所有包的高级地图。
• compare_packages -两个或多个包装的并排比较。
• get_cross_language_coverage -概念\*语言矩阵，显示存在哪些实现以及存在哪些差距。
• get_dependency_graph -ZK-Kit包之间的内部依赖关系图，具有反向依赖关系。

文件和来源

• get_package_readme -带有API文档、示例和审核状态的完整自述文件。支持摘要模式。
• get_package_api -主入口/导出文件（src/index.ts、src/lib.rs、主合同、主电路）。
• get_package_source -浏览目录树或读取包中的任何文件。
• get_package_changelog -逐版本更改、突破性更改和迁移说明。
• search_code -使用GitHub代码搜索在ZK Kit源代码中搜索。

套餐健康与活动

• get_releases -回购的最新版本或按包筛选。
• get_package_commits -特定包的最近提交。
• get_package_downloads -从npm或crates.io下载统计数据。
• get_build_status -最新的CI/CD工作流从GitHub Actions运行。
• get_repo_stats -星、叉、开放问题、最后推送日期、许可证和主题。

依赖关系和问题

• get_package_dependencies -包清单中的运行时、开发和对等依赖关系。
• search_issues -在ZK Kit存储库中搜索GitHub问题。按包、语言或仓库进行范围划分。

提示和资源

提示

1. zk-integration-guide -将ZK Kit包集成到项目中的指导工作流程。
2. zk-concept-explainer -通过ZK Kit实现了解ZK概念（Merkle树、Poseidon、EdDSA等）。
3. troubleshoot-package -ZK工具包问题的指导性故障排除。
4. migration-guide -升级到较新版本或切换到其他语言实现。

所有提示都支持包名自动补全。

资源

• zk-kit://overview -所有软件包的静态生态系统概述。
• zk-kit://packages/{language}/{dirName} -包含语言和目录名完整性的包详细信息。

安装

新巴拿马型船舶

npx zk-kit-mcp

全局安装

npm install -g zk-kit-mcp

来源

git clone https://github.com/trionlabs/zk-kit-mcp.git
cd zk-kit-mcp
npm install
npm run build
node build/index.js

配置

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "zk-kit": {
      "command": "npx",
      "args": ["-y", "zk-kit-mcp"],
      "env": {
        "GITHUB_TOKEN": "your-token-here"
      }
    }
  }
}

VS代码

增添 .vscode/mcp.json 在您的工作空间中：

{
  "servers": {
    "zk-kit": {
      "command": "npx",
      "args": ["-y", "zk-kit-mcp"],
      "env": {
        "GITHUB_TOKEN": "your-token-here"
      }
    }
  }
}

光标

添加到光标MCP配置中：

{
  "mcpServers": {
    "zk-kit": {
      "command": "npx",
      "args": ["-y", "zk-kit-mcp"],
      "env": {
        "GITHUB_TOKEN": "your-token-here"
      }
    }
  }
}

克劳德代码

claude mcp add zk-kit -- npx -y zk-kit-mcp

使用GitHub令牌：

claude mcp add zk-kit --env GITHUB_TOKEN=your-token-here -- npx -y zk-kit-mcp

GitHub代币

可选，但推荐。集 GITHUB_TOKEN 作为环境变量。

• 无令牌：60次请求/小时（GitHub API匿名限制）
• 带令牌：5000个请求/小时

A. 细粒度个人访问令牌 没有权限就足够了，所有ZK Kit存储库都是公共的。

README是从raw.githubusercontent.com获取的，该网站不受GitHub API的费率限制。

运作原理

1. 在启动时从5个GitHub存储库中发现软件包(zk-kit, zk-kit.circom, zk-kit.solidity, zk-kit.noir, zk-kit.rust)
2. 读取元数据清单（package.json、Cargo.toml、Nargo.toml）
3. 把一切都记在记忆里。没有数据库，没有配置文件
4. 按需获取README和更改日志，缓存10分钟TTL

启动需要2-4秒。如果一个仓库不可用，其他仓库的包仍会加载。

发展

npm run dev          # run via tsx (no build needed)
npm test             # vitest (343 tests)
npm run lint         # biome check
npm run build        # tsc + chmod
npx @modelcontextprotocol/inspector node build/index.js  # interactive testing

许可证

麻省理工学院