MCP Servers Nix

mcp-servers-nix

Un framework de configuración basado en Nix para servidores de Protocolo de Control de Modelos (MCP) con paquetes listos para usar.

Resumen

Este repositorio proporciona tanto paquetes de servidores MCP como un framework de Nix para configurar y desplegar servidores MCP. Ofrece un enfoque modular para configurar varios servidores MCP con una interfaz consistente.

Características

• Configuración Modular: Define y combina múltiples configuraciones de servidores MCP
• Builds Reproducibles: Aprovecha Nix para configuraciones de servidores reproducibles y declarativas
• Módulos Preconfigurados: Configuraciones listas para usar para tipos populares de servidores MCP
• Enfocado en Seguridad: Mejor manejo de credenciales e información sensible mediante envFile y passwordCommand, con versiones de servidores fijadas
• Soporte de Frameworks: Se integra con Flakes, flake-parts, devenv y Home Manager

Inicio Rápido

Ejecuta un servidor MCP directamente:

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

Genera un archivo de configuración con mkConfig:

# config.nix
let
  pkgs = import <nixpkgs> { };
  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" ]
    }
  }
}

El formato de salida se adapta a la opción flavor — consulta Variantes Soportadas a continuación.

Variantes Soportadas

Variante	Clave	Archivo Típico	Cliente
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	(varía)	Zed

Módulos Disponibles

• clickup
• codex
• context7
• deepl
• esa
• everything
• fetch
• filesystem
• freee
• git
• github
• grafana
• home-assistant
• mastra
• memory
• netdata
• nixos
• notion
• playwright
• sequential-thinking
• serena
• slite
• tavily
• terraform
• textlint
• time

Ejemplos

Consulta el directorio examples para ejemplos completos de configuración:

• claude-desktop.nix: Configuración básica para Claude Desktop
• vscode.nix: Configuración de integración con VS Code
• librechat.nix: Configuración para integración con LibreChat
• codex.nix: Integración de Codex CLI con servidores MCP
• opencode.nix: Integración de OpenCode CLI con servidores MCP
• vscode-workspace: Ejemplo de configuración de workspace de VS Code
• flake-parts-module: Integración del módulo Flake-parts con soporte multi-variante
• devenv: Integración con devenv usando claude.code.mcpServers
• home-manager: Integración con Home Manager usando programs.mcp.servers

Ejemplos del Mundo Real

Consulta los resultados de búsqueda de GitHub para ver ejemplos de cómo otros están usando mcp-servers-nix en sus proyectos.

Documentación

• Guía de Uso de Módulos — Cómo configurar servidores MCP con Nix (clásico, npins, flakes, flake-parts)
• Referencia de Configuración — Seguridad, manejo de credenciales y opciones de flake-parts
• Referencia de Opciones de Módulos — Lista generada automáticamente de todas las opciones de módulos
• Guía de Paquetes — Uso de paquetes de servidores MCP independientes
• Guía de Contribución — Añadir nuevos paquetes y módulos

Licencia

Este proyecto está licenciado bajo la Apache License 2.0 — consulta el archivo LICENSE para más detalles.