Zig MCP Server

Zig MCP サーバー

最新の Zig に対応した、包括的なビルドシステムサポートを備える 10 倍速の開発アシスタント

最新のビルドシステムサポート、コード最適化、ベストプラクティスのガイダンスなど、包括的な Zig 言語支援を提供する強力な Model Context Protocol（MCP）サーバーです。

🚀 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 サーバーを自動的にインストールするには：

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. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

MIT License — 詳細については LICENSE ファイルをご覧ください。