Zig MCP Server

Zig MCP 服务

现代化 Zig AI 10 倍开发助手，全面支持构建系统

功能强大的模型上下文协议（MCP）服务，可提供全面的 Zig 语言辅助，包括对现代构建系统的支持、代码优化和最佳实践指导。

🚀 v0.2.0+ 新特性

• 🏗️ 支持 Zig 0.15.2+：全面更新，采用现代 b.path() 和 root_module 模式
• 📦 增强模块系统：支持最新模块系统中的 root_module.addImport()
• 🔄 迁移指导：自动检测旧模式并提供升级建议
• 🔧 增强代码分析：改进优化建议和现代模式检测
• 🧪 全面测试：85+ 个测试用例，并提供完整覆盖率报告
• ⚡ 更高的代码质量：修复所有 TypeScript 编译错误和 lint 问题
• 📚 扩展文档：完整的 Zig 0.15.2+ 构建系统指南，附带迁移提示

🛠️ 功能

🏗️ 构建系统工具（新！）

1. 构建系统生成（generate_build_zig）

使用 Zig 0.15.2+ 模式生成现代 build.zig 文件：

• 支持使用最新目标选项进行交叉编译
• 使用 build.zig.zon 进行现代依赖管理
• 集成测试和文档
• 增强模块系统支持

2. 构建系统分析（analyze_build_zig）

分析现有构建文件并获取现代化建议：

• 检测已弃用模式
• 建议 Zig 0.15.2+ 替代方案
• 找出缺失的最佳实践
• 提供模块系统迁移指导

3. 依赖管理（generate_build_zon）

生成 build.zig.zon 文件，以实现现代包管理：

• 热门 Zig 包目录
• 版本管理指导
• 最佳实践文档

功能

工具

1. 代码优化（optimize_code）

增强了对现代 Zig 模式和构建模式分析的支持：

• Debug、ReleaseSafe、ReleaseFast、ReleaseSmall
• 现代化优化建议
• Zig 0.12+ 模式建议

// Example usage
{
  "code": "const std = @import(\"std\");\n...",
  "optimizationLevel": "ReleaseFast"
}

2. 计算单元估算（estimate_compute_units）

估算 Zig 代码的计算复杂度和资源使用情况：

• 内存使用分析
• 时间复杂度估算
• 分配模式检测

// Example usage
{
  "code": "const std = @import(\"std\");\n..."
}

3. 代码生成（generate_code）

根据自然语言描述生成 Zig 代码，支持：

• 错误处理
• 测试
• 性能优化
• 文档

// Example usage
{
  "prompt": "Create a function that sorts an array of integers",
  "context": "Should handle empty arrays and use comptime when possible"
}

4. 代码建议（get_recommendations）

提供代码改进建议和最佳实践：

• 风格和约定
• 设计模式
• 安全注意事项
• 性能分析

// Example usage
{
  "code": "const std = @import(\"std\");\n...",
  "prompt": "Improve performance and safety"
}

资源

1. 语言参考（zig://docs/language-reference）

   • 官方 Zig 语言文档
   • 语法和功能指南
   • 最佳实践

2. 标准库文档（zig://docs/std-lib）

   • 完整的标准库参考
   • 函数签名和用法
   • 示例和说明

3. 热门仓库（zig://repos/popular）

   • GitHub 上的热门 Zig 项目
   • 社区示例和模式
   • 实际应用示例

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Zig MCP Server：

npx -y @smithery/cli install zig-mcp-server --client claude

手动安装

1. 克隆仓库：

git clone [repository-url]
cd zig-mcp-server

2. 安装依赖：

npm install

3. 构建服务：

npm run build

4. 配置环境变量：

# Create a GitHub token for better API rate limits
# https://github.com/settings/tokens
# Required scope: public_repo
GITHUB_TOKEN=your_token_here

5. 添加到 MCP 设置：

{
  "mcpServers": {
    "zig": {
      "command": "node",
      "args": ["/path/to/zig-mcp-server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "your_token_here",
        "NODE_OPTIONS": "--experimental-vm-modules"
      },
      "restart": true
    }
  }
}

使用示例

1. 优化代码

const result = await useMcpTool("zig", "optimize_code", {
  code: `
    pub fn fibonacci(n: u64) u64 {
        if (n <= 1) return n;
        return fibonacci(n - 1) + fibonacci(n - 2);
    }
  `,
  optimizationLevel: "ReleaseFast"
});

2. 估算计算单元

const result = await useMcpTool("zig", "estimate_compute_units", {
  code: `
    pub fn bubbleSort(arr: []i32) void {
        var i: usize = 0;
        while (i < arr.len) : (i += 1) {
            var j: usize = 0;
            while (j < arr.len - 1) : (j += 1) {
                if (arr[j] > arr[j + 1]) {
                    const temp = arr[j];
                    arr[j] = arr[j + 1];
                    arr[j + 1] = temp;
                }
            }
        }
    }
  `
});

3. 生成代码

const result = await useMcpTool("zig", "generate_code", {
  prompt: "Create a thread-safe counter struct",
  context: "Should use atomic operations and handle overflow"
});

4. 获取建议

const result = await useMcpTool("zig", "get_recommendations", {
  code: `
    pub fn main() !void {
        var list = std.ArrayList(u8).init(allocator);
        var i: u32 = 0;
        while (true) {
            if (i >= 100) break;
            try list.append(@intCast(i));
            i += 1;
        }
    }
  `,
  prompt: "performance"
});

开发

项目结构

zig-mcp-server/
├── src/
│   └── index.ts    # Main server implementation
├── build/          # Compiled JavaScript
├── package.json    # Dependencies and scripts
└── tsconfig.json   # TypeScript configuration

构建

# Development build with watch mode
npm run watch

# Production build
npm run build

测试

npm test

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 将分支推送到远程（git push origin feature/amazing-feature）
5. 创建 Pull Request

许可证

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