Nix MCP Servers

This Nix flake provides a declarative configuration for Model Context Protocol (MCP) servers, designed for clients like Claude and Cursor. It supports multiple server types, including Filesystem and GitHub, and offers cross-platform compatibility across NixOS, Darwin, and Home Manager.

Features

• Declarative configuration of MCP servers.
• Supports Claude and Cursor clients.
• Supports Filesystem and GitHub server types.
• Cross-platform support (NixOS, Darwin).
• Integrates with Home Manager.

How it Works

Home Manager modules generate MCP server configuration files for different clients, placing them in the appropriate locations.

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

(Refer to the original README for detailed usage examples.)

Basic Usage

Add the flake to your Home Manager configuration and configure clients and servers.

Custom Configuration Paths

Customize configuration paths for each client.

Development

Clone the repository, make changes, test with nix flake check, and submit a PR.

License

MIT License

Project Overview

This Nix flake offers a unified configuration system for MCP servers across platforms and package managers, handling client-specific formats and paths.

Installation & Usage

(Refer to the original README for detailed installation and usage instructions for NixOS, Home Manager, and nix-darwin.)

CLI Tool

A mcp-servers CLI tool is provided to help configure MCP servers.

Testing Your Setup

Verify the configuration after applying it.

Module Structure

The project uses a modular structure for configuration across platforms, including common options, platform adapters, and library functions.

Project Structure

The project uses flake-parts for a modular structure.

Documentation

(Refer to the original README for documentation links.)

You can also generate and view the options documentation directly with:

nix run github:aloshy-ai/nix-mcp-servers#view-docs

GitHub Pages Documentation

Documentation is automatically built and deployed to GitHub Pages.