Nix MCP Servers

🚀 Nixを使用してMCPサーバーを構成する

このプロジェクトは、Claude DesktopやCursorなど、複数のMCP（Modular Configuration Protocol）クライアントを構成するための統一されたインターフェースを提供します。NixOS、nix - darwin、またはHome Managerを使用している場合、このプロジェクトを通じて簡単にMCPサーバーの設定を管理できます。

🚀 クイックスタート

CLIツールのインストール

nix run github:aloshy-ai/nix-mcp-servers

MCPサーバーの構成

使用しているプラットフォームに応じて、適切な構成ファイルを編集します。

NixOSとnix - darwinの場合

# NixOS
sudo nixos-rebuild test

# nix-darwin
darwin-rebuild test

Home Managerの場合

home-manager switch

構成の検証

生成された構成ファイルが存在するか確認します。

# macOS上のClaude Desktop
cat ~/Library/Application\ Support/Claude/mcp-config.json

# Linux上のClaude Desktop
cat ~/.config/claude-desktop/mcp-config.json

# macOS上のCursor
cat ~/Library/Application\ Support/Cursor/mcp-config.json

# Linux上のCursor
cat ~/.config/Cursor/mcp-config.json

構成したサーバー情報を含むJSONファイルが表示されるはずです。

✨ 主な機能

このプロジェクトは、複数のMCPクライアントの構成を統一的に管理できるインターフェースを提供し、NixOS、nix - darwin、Home Managerのいずれの環境でも利用可能です。

📦 インストール

サポートされるプラットフォーム

• NixOS: nixos-rebuild を使用して構成します。
• nix-darwin: darwin-rebuild を使用して構成します。
• Home Manager: home-manager を使用して構成します。

🔧 技術詳細

モジュール構造

このプロジェクトは、異なるプラットフォームの構成を処理するためにモジュール化された構造を使用しています。

• Common Options: サーバーとクライアントの核心的なモジュールオプションを定義します。
• Platform Adapters: NixOS、Darwin、Home Managerの特定の構成を実装します。
• Library Functions: パス処理、プラットフォーム検出、構成生成の補助関数を提供します。

プロジェクト構造

このプロジェクトは flake-parts を使用してモジュール化されています。

• modules/ - NixOS、Darwin、Home Managerのモジュールを含みます。
  • common/ - 共通のモジュール定義とオプション。
  • nixos/ - NixOS固有の実装。
  • darwin/ - Darwin固有の実装。
  • home-manager/ - Home Managerの実装。
• lib/ - モジュール用のツール関数。
  • clients.nix - クライアント固有の構成処理。
  • servers.nix - サーバー構成のフォーマット。
  • platforms.nix - プラットフォーム検出とパスツール。
  • paths.nix - パス操作関数。
• docs/ - ドキュメント。
  • examples/ - 使用例。
  • modules/ - モジュールのドキュメント。

📚 ドキュメント

• モジュールオプション - 利用可能なすべてのオプションの詳細ドキュメント。
• 使用例 - 異なるプラットフォームの使用例。
• トラブルシューティング - 一般的な問題の解決策。

以下のコマンドを使用して、オプションのドキュメントを直接生成して表示することもできます。

nix run github:aloshy-ai/nix-mcp-servers#view-docs

GitHub Pagesのドキュメント

このプロジェクトは、自動的に構築されてGitHub Pagesにデプロイされるように設定されています。ドキュメントは docs パッケージから生成され、メインブランチに変更がプッシュされるとデプロイされます。この方法では、GitHub Pages環境を手動で構成する必要はありません。

デプロイは peaceiris/actions-gh-pages アクションによって処理され、このアクションはドキュメントを含む gh-pages ブランチを作成します。