Nix MCP Servers

A nix flake for configuring Model Context Protocol (MCP) servers across supported AI assistant clients

Catalog onlyCatalog onlySTDIO

Overview

nix-mcp-servers is a Nix flake designed for configuring Model Context Protocol (MCP) servers across supported AI assistant clients on macOS.

To use nix-mcp-servers, add it to your flake.nix file and configure the desired MCP servers (GitHub, GitLab, or Filesystem) with the necessary access tokens and options.

Automated configuration of MCP servers for AI assistant clients. - Platform-aware client support (macOS only). - Supports multiple MCP server types: GitHub, GitLab, and Filesystem. - Runtime path validation and permissions checking. - Automatic config file management for supported clients.

Configuring GitHub MCP server for AI assistants.
Setting up GitLab MCP server for self-hosted instances.
Managing filesystem access for AI assistant clients.

Add to your AI client

Use these steps to connect Nix MCP Servers in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "nix-mcp-servers-aloshy-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-nix-mcp-servers-aloshy-ai"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "nix-mcp-servers-aloshy-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-nix-mcp-servers-aloshy-ai"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "nix-mcp-servers-aloshy-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-nix-mcp-servers-aloshy-ai"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "nix-mcp-servers-aloshy-ai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-nix-mcp-servers-aloshy-ai"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "nix-mcp-servers-aloshy-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-nix-mcp-servers-aloshy-ai"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "nix-mcp-servers-aloshy-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-nix-mcp-servers-aloshy-ai"
      ]
    }
  }
}

FAQ

Is nix-mcp-servers compatible with other operating systems?

No, it is currently designed for macOS only.

How do I configure the GitHub server?

You need to enable it in your configuration and provide a personal access token.

Can I use multiple servers at once?

Yes, you can configure multiple servers simultaneously in your setup.

Developer tools