MCP Servers Nix

Um framework de configuração baseado em Nix para implantar servidores MCP com pacotes prontos para uso, suportando construções modulares e reproduzíveis.

GitHub

288

Documentação

mcp-servers-nix

Um framework de configuração baseado em Nix para servidores Model Control Protocol (MCP) com pacotes prontos para uso.

Visão Geral

Este repositório fornece tanto pacotes de servidores MCP quanto um framework Nix para configurar e implantar servidores MCP. Ele oferece uma abordagem modular para configurar vários servidores MCP com uma interface consistente.

Recursos

Configuração Modular: Defina e combine múltiplas configurações de servidores MCP
Builds Reproduzíveis: Aproveite o Nix para configurações de servidor reproduzíveis e declarativas
Módulos Pré-configurados: Configurações prontas para uso para tipos populares de servidores MCP
Foco em Segurança: Melhor tratamento de credenciais e informações sensíveis por meio de envFile e passwordCommand, com versões de servidor fixadas
Suporte a Frameworks: Integra-se com Flakes, flake-parts, devenv e Home Manager

Início Rápido

Execute um servidor MCP diretamente:

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

Gere um arquivo de configuração com 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" ]
    }
  }
}

O formato de saída se adapta à opção flavor — veja Flavors Suportados abaixo.

Flavors Suportados

Flavor	Chave	Arquivo 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`	(varia)	Zed

Módulos Disponíveis

Exemplos

Verifique o diretório examples para exemplos completos de configuração:

claude-desktop.nix: Configuração básica para Claude Desktop
vscode.nix: Configuração de integração com VS Code
librechat.nix: Configuração para integração com LibreChat
codex.nix: Integração com Codex CLI e servidores MCP
opencode.nix: Integração com OpenCode CLI e servidores MCP
vscode-workspace: Exemplo de configuração de workspace no VS Code
flake-parts-module: Integração com módulo flake-parts com suporte a múltiplos flavors
devenv: Integração com devenv usando claude.code.mcpServers
home-manager: Integração com Home Manager usando programs.mcp.servers

Exemplos do Mundo Real

Consulte os resultados de busca no GitHub para exemplos de como outras pessoas estão usando mcp-servers-nix em seus projetos.

Documentação

Guia de Uso de Módulos — Como configurar servidores MCP com Nix (clássico, npins, flakes, flake-parts)
Referência de Configuração — Segurança, tratamento de credenciais e opções de flake-parts
Referência de Opções de Módulos — Lista gerada automaticamente de todas as opções de módulos
Guia de Pacotes — Usando pacotes de servidores MCP independentes
Guia de Contribuição — Adicionando novos pacotes e módulos

Licença

Este projeto está licenciado sob a Licença Apache 2.0 — consulte o arquivo LICENSE para detalhes.