Mcp Servers Nix

mcp-servers-nix

A Nix-based configuration framework for Model Control Protocol (MCP) servers with ready-to-use packages.

Overview

This repository provides both MCP server packages and a Nix framework for configuring and deploying MCP servers. It offers a modular approach to configuring various MCP servers with a consistent interface.

Features

• Modular Configuration: Define and combine multiple MCP server configurations
• Reproducible Builds: Leverage Nix for reproducible and declarative server setups
• Pre-configured Modules: Ready-to-use configurations for popular MCP server types
• Security-focused: Better handling credentials and sensitive information through envFile and passwordCommand, with pinned server versions
• Framework Support: Integrates with [Flakes](docs/module-usage.md#using-flakes), [flake-parts](docs/module-usage.md#using-flake-parts), [devenv](docs/module-usage.md#using-devenv), and [Home Manager](docs/module-usage.md#using-home-manager)

Quick Start

Run an MCP server directly:

nix run github:natsukium/mcp-servers-nix#mcp-server-fetch

Generate a configuration file with mkConfig:

# config.nix
let
  pkgs = import  { };
  mcp-servers-nix = import (fetchTarball
    "https://github.com/natsukium/mcp-servers-nix/archive/main.tar.gz") { inherit pkgs; };
in
mcp-servers-nix.lib.mkConfig pkgs {
  programs.filesystem = {
    enable = true;
    args = [ "/path/to/allowed/directory" ];
  };
}

nix-build config.nix && cat result

{
  "mcpServers": {
    "filesystem": {
      "command": "/nix/store/7b4ancp3cns9lkkybd090qzr0hah5qq0-mcp-server-filesystem-2025.12.18/bin/mcp-server-filesystem",
      "args": [ "/path/to/allowed/directory" ]
    }
  }
}

The output format adapts to the flavor option — see [Supported Flavors](#supported-flavors) below.

Supported Flavors

| Flavor | Key | Typical File | Client | |--------|-----|-------------|--------| | claude | mcpServers | claude_desktop_config.json | Claude Desktop | | claude-code | mcpServers | .mcp.json | Claude Code | | vscode | mcp.servers | settings.json | VS Code | | vscode-workspace | servers | .vscode/mcp.json | VS Code (workspace) | | codex | mcp_servers | .mcp.toml | Codex CLI | | opencode | mcp | opencode.json | OpenCode | | zed | context_servers | (varies) | Zed |

Available Modules

• [clickup](./modules/servers/clickup.nix)
• [codex](./modules/servers/codex.nix)
• [context7](./modules/servers/context7.nix)
• [deepl](./modules/servers/deepl.nix)
• [esa](./modules/servers/esa.nix)
• [everything](./modules/servers/everything.nix)
• [fetch](./modules/servers/fetch.nix)
• [filesystem](./modules/servers/filesystem.nix)
• [freee](./modules/servers/freee.nix)
• [git](./modules/servers/git.nix)
• [github](./modules/servers/github.nix)
• [grafana](./modules/servers/grafana.nix)
• [home-assistant](./modules/servers/home-assistant.nix)
• [mastra](./modules/servers/mastra.nix)
• [memory](./modules/servers/memory.nix)
• [netdata](./modules/servers/netdata.nix)
• [nixos](./modules/servers/nixos.nix)
• [notion](./modules/servers/notion.nix)
• [playwright](./modules/servers/playwright.nix)
• [sequential-thinking](./modules/servers/sequential-thinking.nix)
• [serena](./modules/servers/serena.nix)
• [slite](./modules/servers/slite.nix)
• [tavily](./modules/servers/tavily.nix)
• [terraform](./modules/servers/terraform.nix)
• [textlint](./modules/servers/textlint.nix)
• [time](./modules/servers/time.nix)

Examples

Check the examples directory for complete configuration examples:

• [claude-desktop.nix](./examples/claude-desktop.nix): Basic configuration for Claude Desktop
• [vscode.nix](./examples/vscode.nix): VS Code integration setup
• [librechat.nix](./examples/librechat.nix): Configuration for LibreChat integration
• [codex.nix](./examples/codex.nix): Codex CLI integration with MCP servers
• [opencode.nix](./examples/opencode.nix): OpenCode CLI integration with MCP servers
• [vscode-workspace](./examples/vscode-workspace/flake.nix): VS Code workspace configuration example
• [flake-parts-module](./examples/flake-parts-module/flake.nix): Flake-parts module integration with multi-flavor support
• [devenv](./examples/devenv): devenv integration using claude.code.mcpServers
• [home-manager](./examples/home-manager/flake.nix): Home Manager integration with programs.mcp.servers

Real World Examples

Check out GitHub search results for examples of how others are using mcp-servers-nix in their projects.

Documentation

• [Module Usage Guide](docs/module-usage.md) — How to configure MCP servers with Nix (classic, npins, flakes, flake-parts)
• [Configuration Reference](docs/configuration-reference.md) — Security, credential handling, and flake-parts options
• [Module Options Reference](docs/module-options.md) — Auto-generated list of all module options
• [Packages Guide](docs/packages.md) — Using standalone MCP server packages
• [Contributing Guide](CONTRIBUTING.md) — Adding new packages and modules

License

This project is licensed under the Apache License 2.0 - see the [LICENSE file](./LICENSE) for details.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: natsukium
• Source: natsukium/mcp-servers-nix
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.