Nix MCP Servers

🚀 使用 Nix 配置你的 MCP 服務器

本項目提供了一個統一接口，可用於配置多個 MCP（Modular Configuration Protocol）客戶端，像 Claude Desktop 和 Cursor 等。無論你使用的是 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：使用 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 分支。