Nix MCP Servers

Nix MCP Servers

site icon
2025.03.15 7
NixAI 模型配置Nix 配置管理开发效率
Nix MCP Servers 是一个用于声明式配置 MCP(Model Context Protocol)服务器的 Nix flake,支持多种客户端(如 Claude 和 Cursor)和服务器类型(如文件系统和 GitHub)。它通过 Home Manager 与现有的 Nix 配置集成,提供跨平台支持(NixOS 和 Darwin)。
View on GitHub

Overview

基本能力

产品定位

Nix MCP Servers 是一个用于声明式配置 MCP(Model Context Protocol)服务器的工具,旨在为 AI 模型提供统一的配置系统,支持多种客户端和服务器类型。

核心功能

  • 声明式配置 MCP 服务器
  • 支持多种客户端(Claude, Cursor)
  • 支持多种服务器类型(文件系统, GitHub)
  • 跨平台支持(NixOS, Darwin)
  • 使用 Home Manager 与现有 Nix 配置集成

适用场景

  • 为 AI 助手(如 Claude)配置文件系统或 GitHub 访问
  • 为代码编辑器(如 Cursor)配置 MCP 服务器
  • 在 NixOS 或 Darwin 系统上统一管理 MCP 服务器配置

工具列表

  • mcp-servers CLI 工具:用于配置 MCP 服务器

常见问题解答

  • 如何验证配置是否正确应用?
  • 检查生成的配置文件路径(如 ~/Library/Application Support/Claude/mcp-config.json
  • 如何自定义配置路径?
  • 在配置中覆盖 configPathclients.cursor.configPath

使用教程

使用依赖

  • 需要安装 Nix 和 Home Manager

安装教程

  1. 将 flake 添加到 home-manager 配置中:
{
  inputs = {
    nix-mcp-servers.url = "github:yourusername/nix-mcp-servers";
  };

  outputs = { nixpkgs, home-manager, nix-mcp-servers, ... }: {
    homeConfigurations."yourusername" = home-manager.lib.homeManagerConfiguration {
      modules = [
        nix-mcp-servers.homeManagerModules.default
        {
          nix-mcp-servers = {
            clients.generateConfigs = true;
            clients.cursor = {
              enable = true;
              filesystem = {
                enable = true;
                paths = [
                  "/Users/yourusername/projects"
                ];
              };
            };
          };
        }
      ];
    };
  };
}

调试方式

  1. 应用配置后,检查配置文件是否存在:
cat ~/Library/Application\ Support/Claude/mcp-config.json
  1. 验证配置是否正确:
home-manager switch

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。