mcp-servers-nix

mcp-servers-nix

すぐに使えるパッケージを備えた、Model Control Protocol（MCP）サーバー向けのNixベースの設定フレームワークです。

概要

このリポジトリでは、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オプションに応じて変わります。詳しくは、以下の対応するFlavorを参照してください。

対応するFlavor

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：MCP サーバーを使用したCodex CLIとの統合
• opencode.nix：MCP サーバーを使用したOpenCode CLIとの統合
• vscode-workspace：VS Codeワークスペースの設定例
• flake-parts-module：複数のFlavorをサポートするFlake-partsモジュールの統合
• devenv：claude.code.mcpServersを使用したdevenvとの統合
• home-manager：programs.mcp.serversを使用したHome Managerとの統合

実際の使用例

他のプロジェクトで mcp-servers-nix がどのように使われているか、GitHub の検索結果をご覧ください。

ドキュメント

• モジュールの使用ガイド — Nix（従来の形式、npins、flakes、flake-parts）で MCP サーバーを設定する方法
• 設定リファレンス — セキュリティ、認証情報の取り扱い、flake-parts のオプション
• モジュールオプションリファレンス — すべてのモジュールオプションを自動生成した一覧
• パッケージガイド — スタンドアロンの MCP サーバーパッケージを使用する方法
• 貢献ガイド — 新しいパッケージとモジュールの追加方法

ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。