Zig MCP Server

Zig MCP服务器

具有全面构建系统支持的现代Zig AI 10x开发助手

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

🚀 v0.2.0的新增功能+

• 🏗️ Zig 0.15.2+支持：完全更新为现代 b.path() 和 root_module 模式
• 📦 增强型模块系统：支持最新的模块系统 root_module.addImport()
• 🔄 迁移指导：对遗留模式的自动检测和升级建议
• 🔧 增强的代码分析：改进的优化建议和现代模式检测
• 🧪 综合测试：85多个测试用例，具有全覆盖报告
• ⚡ 更好的代码质量：修复了所有TypeScript编译错误和linting问题
• 📚 扩展文档：完整的Zig 0.15.2+构建系统指南，包括迁移提示

🛠️ 特性

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

1.构建系统生成(generate_build_zig)

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

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

2.构建系统分析(analyze_build_zig)

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

• 检测已弃用的模式
• 建议Zig 0.15.2+替代方案
• 识别缺失的最佳实践
• 模块系统迁移指南

3.依赖关系管理(generate_build_zon)

为现代包管理生成build.zip文件：

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

特性

工具

1.代码优化(optimize_code)

通过现代Zig模式和构建模式分析进行了增强：

• 调试、释放安全、释放快速、释放小
• 现代优化建议
• 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语言文档 - 语法和功能指南 - 最佳实践

1. 标准库文档 (zig://docs/std-lib)

- 完整的std库参考 - 函数签名和用法 - 示例和注释

1. 热门存储库 (zig://repos/popular)

- GitHub上的热门Zig项目 - 社区示例和模式 - 现实世界的实施

安装

通过Smithery安装

通过以下方式自动安装Claude Desktop的Zig MCP服务器 史密瑟里:

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

手动安装

1. 克隆存储库：

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

1. 安装依赖项：

npm install

1. 构建服务器：

npm run build

1. 配置环境变量：

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

1. 添加到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  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. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add some amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。