Nix MCP Servers

A Nix flake for declaratively configuring MCP (Model Context Protocol) servers for clients like Claude and Cursor.

Features

• Declarative configuration of MCP servers
• Support for multiple clients (Claude, Cursor)
• Support for multiple server types (filesystem, github)
• Cross-platform support (NixOS, Darwin)
• Uses Home Manager for integration with your existing Nix configuration

How it Works

This flake provides Home Manager modules that generate MCP server configuration files for different clients. When you enable a server for a client, the necessary configuration is generated and placed in the appropriate location for that client.

Supported Servers

• Filesystem: Provides filesystem access to AI models
• GitHub: Provides GitHub access to AI models

Supported Clients

• Claude: Anthropic’s Claude AI assistant
• Cursor: The Cursor code editor

Usage

Basic Usage

Add this flake to your home-manager configuration:

{
  inputs = {
    # ... your other inputs
    nix-mcp-servers.url = "github:yourusername/nix-mcp-servers";
  };

  outputs = { nixpkgs, home-manager, nix-mcp-servers, ... }: {
    homeConfigurations."yourusername" = home-manager.lib.homeManagerConfiguration {
      # ... your other configuration
      modules = [
        nix-mcp-servers.homeManagerModules.default
        
        # Your configuration
        {
          nix-mcp-servers = {
            # Enable configuration generation
            clients.generateConfigs = true;
            
            # Configure Cursor client
            clients.cursor = {
              enable = true;
              
              # Enable filesystem server for Cursor
              filesystem = {
                enable = true;
                paths = [
                  "/Users/yourusername/projects"
                  "/Users/yourusername/Documents"
                ];
              };
              
              # Enable GitHub server for Cursor
              github = {
                enable = true;
                token = "your-github-token";
              };
            };
            
            # Configure Claude client
            clients.claude = {
              enable = true;
              
              # Only enable filesystem for Claude
              filesystem = {
                enable = true;
                paths = [
                  "/Users/yourusername/projects"
                ];
              };