MCP Servers Nix

一個基於Nix的模型控制協議(MCP)服務器配置框架，提供模塊化配置和預構建的服務器包，支持安全部署和可重複構建。

開發者工具安全 #Nix配置 #MCP服務 #模塊化 #安全部署

評分 : 2.5分

下載量 : 6.0K

更新時間 : 2025-04-28

打開站點

什麼是MCP服務器？

MCP（Model Context Protocol）服務器是一種用於模型驅動應用的中間件，支持多協議交互和安全的數據傳輸。

如何使用MCP服務器？

通過Nix配置框架，您可以輕鬆定義和組合多種MCP服務器模塊，快速實現所需功能。

適用場景

適用於需要高效、安全的模型集成和數據處理的企業級應用。

主要功能

模塊化配置

支持多種MCP服務器模塊的自由組合，滿足個性化需求。

可重現構建

利用Nix實現每次部署的完全一致性和安全性。

注重安全

通過環境變量和密碼管理器無縫集成敏感信息保護。

優勢

高度可定製化

安全可靠

支持多種協議

侷限性

學習曲線較陡

對Nix環境有一定依賴

如何使用

安裝Nix

確保您的系統已安裝Nix包管理器。

克隆倉庫

獲取MCP服務器配置框架。

配置模塊

編輯配置文件以啟用所需模塊。

使用案例

VS Code集成

將MCP服務器與VS Code協同工作，提升開發效率。

LibreChat集成

通過MCP服務器增強聊天機器人功能。

常見問題

MCP服務器是否支持雲部署？

如何更新MCP服務器版本？

🚀 MCP 服務器配置指南

本指南詳細介紹了 MCP 服務器的安裝、配置、擴展、自定義、測試、問題排查等內容，幫助你快速搭建和管理 MCP 服務器。

🚀 快速開始

安裝與基本配置

使用 flakes 的安裝方式

git clone https://github.com/yourusername/mcp-servers-nix.git
cd mcp-servers-nix
nix flake add . nixpkgs

不使用 flakes 的安裝方式

git clone https://github.com/yourusername/mcp-servers-nix.git
cd mcp-servers-nix
nix-env -f . -i mcp-servers-nix

📦 安裝指南

配置示例

默認配置

{
  mcp-servers.lib.mkConfig pkgs {
    programs = {
      filesystem = {
        enable = true;
        args = [ "/path/to/allowed/directory" ];
      };
    };
  };
}

自定義配置

mcp-servers-nix.mcp-servers.lib.mkConfig pkgs {
  format = "yaml";
  fileName = "config.yaml";

  programs = {
    filesystem = {
      enable = true;
      args = [ "/path/to/allowed/directory" ];
    };
  };

  settings.servers = {
    custom-server = {
      command = "${pkgs.lib.getExe pkgs.nodejs "npx"}";
      args = [
        "-y"
        "custom-server-package"
        "/path/to/custom/server/path"
      ];
    };
  };
}

🔧 技術細節

擴展框架

添加新服務器包

官方包：放置在 pkgs/official/ 目錄下。
參考實現：放置在 pkgs/reference/ 目錄下。
社區實現：放置在 pkgs/community/ 目錄下。

示例：添加新官方服務器包

創建一個新的包定義文件 pkgs/official/new-mcp-server/default.nix：

{
  lib,
  fetchFromGitHub,
  buildNpmPackage,
}:

buildNpmPackage rec {
  pname = "new-mcp-server";
  version = "0.1.0";

  src = fetchFromGitHub {
    owner = "new-mcp-server";
    repo = "new-mcp-server";
    tag = "v${version}";
    hash = "sha256-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA";
  };

  npmDepsHash = "sha256-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA";

  meta = {
    description = "New MCP server";
    homepage = "https://github.com/new-mcp-server/new-mcp-server";
    license = lib.licenses.asl20;
    maintainers = with lib.maintainers; [ username ];
    mainProgram = "new-mcp-server";
  };
}

然後在 pkgs/default.nix 中註冊：

{
  # ... 已經存在的包 ...
  
  new-mcp-server = pkgs.callPackage ./official/new-mcp-server { };
}

模塊配置

創建一個新的模塊文件 modules/new-mcp-server.nix：

{ mkServerModule, ... }:
{
  imports = [
    (mkServerModule {
      name = "new-mcp-server";
      packageName = "new-mcp-server";
    })
  ];
}

自定義模塊選項

定義自定義選項

在 modules/new-mcp-server.nix 中添加：

{ config, pkgs, lib, mkServerModule, ... }:
let
  cfg = config.programs.new-mcp-server;
in
{
  imports = [
    (mkServerModule {
      name = "new-mcp-server";
      packageName = "new-mcp-server";
    })
  ];

  configuration = {
    options = {
      customOption ?= {
        type = "string";
        description = "A custom option for the new mcp server";
      };
    };

    content = {
      programs.new-mcp-server.enable = cfg.enable;
      programs.new-mcp-server.customOption = cfg.customOption;
    };
  };
}

💻 使用示例

測試與驗證

使用 flakes 進行測試

nix flake test .

不使用 flakes 的測試方式

nix-shell --pure -E 'let { nixpkgs ?= import (fetchTarball "https://github.com/nix-community/interpreters/archive/master.tar.gz") {}; }' -I nixpkgs=. --run 'your-test-command'