mcp-servers-nix

mcp-servers-nix

基于 Nix 的 Model Control Protocol（MCP）服务配置框架，提供开箱即用的软件包。

概述

此仓库同时提供 MCP 服务软件包，以及用于配置和部署 MCP 服务的 Nix 框架。它采用模块化方式，以一致的接口配置各种 MCP 服务。

功能

• 模块化配置：定义和组合多个 MCP 服务配置
• 可复现构建：利用 Nix 实现可复现、声明式的服务配置
• 预配置模块：为常用 MCP 服务类型提供开箱即用的配置
• 注重安全：通过 envFile 和 passwordCommand 更好地处理凭据和敏感信息，并固定服务版本
• 框架支持：集成 Flakes、flake-parts、devenv 和 Home Manager

快速开始

直接运行 MCP 服务：

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

使用 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" ]
    }
  }
}

输出格式会根据 flavor 选项调整，详见下文的支持的风格。

支持的风格

风格	键	常见文件	客户端
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（工作区）
codex	mcp_servers	.mcp.toml	Codex CLI
opencode	mcp	opencode.json	OpenCode
zed	context_servers	（因情况而异）	Zed

可用模块

• 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

示例

完整配置示例请参阅 examples 目录：

• claude-desktop.nix：Claude Desktop 的基本配置
• vscode.nix：VS Code 集成设置
• librechat.nix：LibreChat 集成配置
• codex.nix：将 Codex CLI 与 MCP 服务集成
• opencode.nix：将 OpenCode CLI 与 MCP 服务集成
• vscode-workspace：VS Code 工作区配置示例
• flake-parts-module：支持多种风格的 Flake-parts 模块集成
• devenv：使用 claude.code.mcpServers 的 devenv 集成
• home-manager：通过 programs.mcp.servers 集成 Home Manager

真实案例

查看 GitHub 搜索结果，了解其他人在项目中使用 mcp-servers-nix 的示例。

文档

• 模块使用指南 — 如何使用 Nix 配置 MCP 服务（classic、npins、flakes、flake-parts）
• 配置参考 — 安全性、凭据处理和 flake-parts 选项
• 模块选项参考 — 自动生成的所有模块选项列表
• 软件包指南 — 如何使用独立的 MCP 服务软件包
• 贡献指南 — 添加新软件包和模块

许可证

本项目采用 Apache License 2.0 许可，详情请参阅 LICENSE 文件。