使用 Nix 配置你的 MCP 服务器

简介

这个项目提供了一个统一的接口来配置多个 MCP（Modular Configuration Protocol）客户端，如 Claude Desktop 和 Cursor。无论你使用的是 NixOS、nix-darwin 还是 Home Manager，都可以通过这个项目轻松管理你的 MCP 服务器设置。

支持的平台

• NixOS: 使用 nixos-rebuild 进行配置
• nix-darwin: 使用 darwin-rebuild 进行配置
• Home Manager: 使用 home-manager 进行配置

快速开始

安装 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 文件。

模块结构

该项目使用了模块化结构来处理不同平台的配置：

• 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 分支，其中包含文档。