mcp-servers-nix

What is mcp-servers-nix?

mcp-servers-nix is a Nix-based configuration framework for Model Context Protocol (MCP) servers that offers ready-to-use packages and a modular approach for defining and deploying MCP server configurations. It leverages Nix for reproducible and declarative server setups, making it suitable for users who want a consistent, security-conscious way to manage MCP servers across different clients.

How to use mcp-servers-nix?

You can run an MCP server directly with nix run github:natsukium/mcp-servers-nix#mcp-server-fetch or generate a configuration file using the mkConfig function within a Nix expression. The output format adapts to a chosen flavor (e.g., claude, vscode, codex). Examples for Claude Desktop, VS Code, Codex CLI, and others are provided in the examples directory.

Key features of mcp-servers-nix

• Modular configuration with consistent interface
• Reproducible builds via Nix
• Pre-configured modules for popular MCP server types
• Security-focused credential handling through envFile and passwordCommand
• Integration with Flakes, flake-parts, devenv, and Home Manager

Use cases of mcp-servers-nix

• Declaratively configuring MCP servers for Claude Desktop, VS Code, or Claude Code
• Deploying MCP servers with secure credential management in Nix environments
• Setting up reproducible MCP server configurations across multiple machines
• Combining multiple MCP servers (e.g., filesystem, GitHub, git) in a single config
• Using flake-parts or devenv to integrate MCP servers into existing Nix-based projects

FAQ from mcp-servers-nix

What is mcp-servers-nix and what problems does it solve?

mcp-servers-nix provides a Nix-based framework to configure and deploy MCP servers. It offers ready-to-use packages, modular configurations, and reproducible builds, while improving security through credential handling via envFile and passwordCommand.

How do I run an MCP server using mcp-servers-nix?

Run a server directly with nix run github:natsukium/mcp-servers-nix#mcp-server-fetch or generate a configuration file by calling mkConfig in a Nix expression. The output can be written to the corresponding client’s config file.

Which client flavors are supported?

mcp-servers-nix supports Claude Desktop, Claude Code, VS Code, VS Code (workspace), Codex CLI, OpenCode, and Zed. Each flavor outputs configuration in the format expected by the respective client.

How does mcp-servers-nix handle credentials and secrets?

The framework provides envFile and passwordCommand options for secure injection of credentials and sensitive information, with pinned server versions to reduce supply-chain risks.

What dependencies are required to use mcp-servers-nix?

You need the Nix package manager. Optional integrations include Flakes, flake-parts, devenv, and Home Manager. The server modules themselves require no additional runtime beyond Nix.