Claude-code.nix

mcps.nix

一个精心策划的MCP（模型上下文协议）服务器预设库，用于 克劳德 代码 它与本地Claude模块集成在 devenv 和 家 经理.

概述

devenv和home manager现在都对Claude Code配置提供了本机支持：

• 家庭经理: programs.claude-code
• devenv: claude.code

此项目提供了可重用的MCP服务器配置（预设），可与这些配置配合使用 本机模块，允许您轻松启用和配置流行的MCP服务器，而无需 手动JSON配置。

特性

• 预配置的MCP服务器：为包括Asana在内的流行MCP服务器内置预设，

GitHub、Buildkite、Git、文件系统、LSP集成等

• 安全凭据管理：支持从文件中读取API令牌，而不是

环境变量

• 本机集成：与devenv和home manager中的上游Claude模块配合使用

• 两种家庭经理选项：在本机集成或基于自定义脚本之间进行选择

安装

• 可扩展：在预设旁边添加自定义MCP服务器

快速开始

将此flake的覆盖层添加到您的nixpkgs导入中。

let
  pkgs = import nixpkgs {
    overlays = [ inputs.mcps.overlays.default ];
  };
in
# ...

与devenv一起使用

添加到您的devenv模块配置中：

{
  imports = [ inputs.mcps.devenvModules.claude ];

  claude.code = {
    enable = true;
    mcps = {
      git.enable = true;
      filesystem = {
        enable = true;
        allowedPaths = [ "/path/to/your/project" ];
      };
      github = {
        enable = true;
        tokenFilepath = "/path/to/github-token";
      };
    };
  };
}

与Home Manager一起使用

该项目提供两个Home Manager模块：

选项1：本地集成（推荐）

与家庭经理的原生Claude Code支持集成。MCP服务器通过Nix进行管理，并存储在Nix存储中：

{
  imports = [ inputs.mcps.homeManagerModules.claude ];

  programs.claude-code = {
    enable = true;
    mcps = {
      git.enable = true;
      filesystem = {
        enable = true;
        allowedPaths = [ "${config.home.homeDirectory}/Projects" ];
      };
      asana = {
        enable = true;
        tokenFilepath = "/var/run/agenix/asana.token";
      };
    };
  };
}

选项2：基于脚本的安装

使用Claude CLI管理中的MCP服务器 ~/.claude.json。如果您：

• 希望您的MCP服务器配置保持不变 ~/.claude.json
• 需要在Nix之外手动管理或编辑MCP服务器
• 更喜欢将自定义MCP配置保存在主目录中

{
  imports = [ inputs.mcps.homeManagerModules.claude-install ];

  programs.claude-code = {
    enable = true;
    mcps = {
      git.enable = true;
      buildkite = {
        enable = true;
        apiKeyFilepath = "/path/to/buildkite-token";
      };
    };
  };
}

可用的MCP服务器

内置预设

模块结构

该项目现在提供了与原生Claude Code支持集成的重点模块：

• devenvModules.claude：添加 claude.code.mcps 配置到devenv的本机 claude.code 模块
• homeManagerModules.claude：添加 programs.claude-code.mcps 配置家庭经理的原生Claude模块
• homeManagerModules.claude-install：使用Claude CLI进行管理的替代家庭管理器模块 ~/.claude.json

所有模块都提供对相同预设MCP服务器配置的访问，使您能够使用简单的布尔标志轻松启用流行的MCP服务器。

安全特性

• 凭证文件支持：所有MCP服务器都支持从文件中读取凭据，而不是从环境变量中读取凭据
• 路径限制：文件系统访问仅限于明确允许的路径
• 无凭证风险：API令牌和密钥从未在Nix存储中公开

贡献

看 贡献.md 用于开发设置、测试和贡献指南。

许可证

该项目根据MIT许可证获得许可。