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 分支。