{"id":26827761,"url":"https://github.com/utensils/mcp-nixos","last_synced_at":"2026-01-27T01:04:00.062Z","repository":{"id":283416218,"uuid":"951693330","full_name":"utensils/mcp-nixos","owner":"utensils","description":"MCP-NixOS - Model Context Protocol Server for NixOS resources","archived":false,"fork":false,"pushed_at":"2025-04-25T16:38:03.000Z","size":2278,"stargazers_count":78,"open_issues_count":3,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-29T22:58:48.008Z","etag":null,"topics":["ai-assistant","ai-integration","ai-tools","anthropic","claude","developer-tools","devops-tools","fastmcp","llm-tools","mcp","model-context-protocol","nix","nix-options","nix-packages","nix-search","nixos","package-search","python","sre-tools"],"latest_commit_sha":null,"homepage":"https://mcp-nixos.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/utensils.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-20T05:05:00.000Z","updated_at":"2025-04-29T00:01:16.000Z","dependencies_parsed_at":"2025-04-20T09:31:40.621Z","dependency_job_id":"1150af7f-1ee2-444a-9b1b-f922c3dcf405","html_url":"https://github.com/utensils/mcp-nixos","commit_stats":null,"previous_names":["utensils/nixmcp","utensils/mcp-nixos"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utensils%2Fmcp-nixos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utensils%2Fmcp-nixos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utensils%2Fmcp-nixos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utensils%2Fmcp-nixos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/utensils","download_url":"https://codeload.github.com/utensils/mcp-nixos/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251596666,"owners_count":21615017,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","ai-integration","ai-tools","anthropic","claude","developer-tools","devops-tools","fastmcp","llm-tools","mcp","model-context-protocol","nix","nix-options","nix-packages","nix-search","nixos","package-search","python","sre-tools"],"created_at":"2025-03-30T12:17:00.621Z","updated_at":"2026-01-27T01:04:00.011Z","avatar_url":"https://github.com/utensils.png","language":"Python","funding_links":[],"categories":["Developer Tools","Data Access \u0026 Integration MCP Servers","MCP","📚 Projects (1974 total)","پیاده‌سازی‌های سرور","HTML","APIs and HTTP Requests","Development","Python","MCP Frameworks and libraries","📦 Other","MCP Servers \u0026 Protocol","Server Implementations"],"sub_categories":["CI/CD \u0026 DevOps","MCP Servers","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eابزارهای توسعه‌دهنده","How to Submit","Python","Discovery","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eDeveloper Tools"],"readme":"# MCP-NixOS - Because Your AI Shouldn't Hallucinate Package Names\n\n[![CI](https://github.com/utensils/mcp-nixos/actions/workflows/ci.yml/badge.svg)](https://github.com/utensils/mcp-nixos/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/utensils/mcp-nixos/graph/badge.svg?token=kdcbgvq4Bh)](https://codecov.io/gh/utensils/mcp-nixos)\n[![PyPI](https://img.shields.io/pypi/v/mcp-nixos.svg)](https://pypi.org/project/mcp-nixos/)\n[![FlakeHub](https://img.shields.io/endpoint?url=https://flakehub.com/f/utensils/mcp-nixos/badge)](https://flakehub.com/flake/utensils/mcp-nixos)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n![CodeRabbit Pull Request Reviews](https://img.shields.io/coderabbit/prs/github/utensils/mcp-nixos?utm_source=oss\u0026utm_medium=github\u0026utm_campaign=utensils%2Fmcp-nixos\u0026labelColor=171717\u0026color=FF570A\u0026link=https%3A%2F%2Fcoderabbit.ai\u0026label=CodeRabbit+Reviews)\n[![Built with Claude](https://img.shields.io/badge/Built%20with-Claude-D97757?logo=claude\u0026logoColor=white)](https://claude.ai)\n\n## Quick Start\n\n**🚨 No Nix/NixOS Required!** Works on any system - Windows, macOS, Linux. You're just querying APIs.\n\n### Option 1: uvx (Recommended)\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=nixos\u0026config=eyJjb21tYW5kIjoidXZ4IG1jcC1uaXhvcyJ9)\n\n```json\n{\n  \"mcpServers\": {\n    \"nixos\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-nixos\"]\n    }\n  }\n}\n```\n\n### Option 2: Nix\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=nixos\u0026config=eyJjb21tYW5kIjoibml4IHJ1biBnaXRodWI6dXRlbnNpbHMvbWNwLW5peG9zIC0tIn0%3D)\n\n```json\n{\n  \"mcpServers\": {\n    \"nixos\": {\n      \"command\": \"nix\",\n      \"args\": [\"run\", \"github:utensils/mcp-nixos\", \"--\"]\n    }\n  }\n}\n```\n\n### Option 3: Docker\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=nixos\u0026config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItLXJtIiwiLWkiLCJnaGNyLmlvL3V0ZW5zaWxzL21jcC1uaXhvcyJdfQ%3D%3D)\n\n```json\n{\n  \"mcpServers\": {\n    \"nixos\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"--rm\", \"-i\", \"ghcr.io/utensils/mcp-nixos\"]\n    }\n  }\n}\n```\n\nYour AI now has access to real NixOS data instead of making things up. You're welcome.\n\n## What Is This?\n\nAn MCP server providing accurate, real-time information about:\n\n- **NixOS packages** - 130K+ packages that actually exist\n- **NixOS options** - 23K+ ways to configure your system\n- **Home Manager** - 5K+ options for dotfile enthusiasts\n- **nix-darwin** - 1K+ macOS settings Apple doesn't document\n- **Nixvim** - 5K+ options for Neovim configuration via [NuschtOS search](https://github.com/NuschtOS/search)\n- **FlakeHub** - 600+ flakes from [FlakeHub.com](https://flakehub.com) registry\n- **Package versions** - Historical versions with commit hashes via [NixHub.io](https://www.nixhub.io)\n\n## The Tools\n\nJust two. We consolidated 17 tools into 2 because your AI's context window isn't infinite.\n\n**~365 tokens total.** That's it. While other MCP servers are hogging your context like it's Black Friday, we're sipping minimalist tea in the corner. Your AI gets NixOS superpowers without the bloat.\n\n### `nix` - Unified Query Tool\n\nOne tool to rule them all:\n\n```text\nnix(action, query, source, type, channel, limit)\n```\n\n| Action | What it does |\n|--------|-------------|\n| `search` | Search packages, options, programs, or flakes |\n| `info` | Get detailed info about a package or option |\n| `stats` | Get counts and categories |\n| `options` | Browse Home Manager/Darwin options by prefix |\n| `channels` | List available NixOS channels |\n\n| Source | What it queries |\n|--------|----------------|\n| `nixos` | Packages, options, programs |\n| `home-manager` | Home Manager options |\n| `darwin` | nix-darwin options |\n| `flakes` | Community flakes (search.nixos.org) |\n| `flakehub` | FlakeHub registry (flakehub.com) |\n| `nixvim` | Nixvim Neovim configuration options |\n\n**Examples:**\n\n```python\n# Search NixOS packages\nnix(action=\"search\", query=\"firefox\", source=\"nixos\", type=\"packages\")\n\n# Get package info\nnix(action=\"info\", query=\"firefox\", source=\"nixos\", type=\"package\")\n\n# Search Home Manager options\nnix(action=\"search\", query=\"git\", source=\"home-manager\")\n\n# Browse darwin options\nnix(action=\"options\", source=\"darwin\", query=\"system.defaults\")\n\n# Search Nixvim options\nnix(action=\"search\", query=\"telescope\", source=\"nixvim\")\n\n# Get Nixvim option info\nnix(action=\"info\", query=\"plugins.telescope.enable\", source=\"nixvim\")\n\n# Search FlakeHub\nnix(action=\"search\", query=\"nixpkgs\", source=\"flakehub\")\n\n# Get FlakeHub flake info\nnix(action=\"info\", query=\"NixOS/nixpkgs\", source=\"flakehub\")\n\n# Get stats\nnix(action=\"stats\", source=\"nixos\", channel=\"stable\")\n```\n\n### `nix_versions` - Package Version History\n\nFind historical versions with nixpkgs commit hashes:\n\n```\nnix_versions(package, version, limit)\n```\n\n**Examples:**\n\n```python\n# List recent versions\nnix_versions(package=\"python\", limit=5)\n\n# Find specific version\nnix_versions(package=\"nodejs\", version=\"20.0.0\")\n```\n\n## Installation\n\n**You DON'T need Nix installed.** This runs anywhere Python runs.\n\n```bash\n# Run directly (no install)\nuvx mcp-nixos\n\n# Or install\npip install mcp-nixos\n```\n\nFor Nix users:\n\n```bash\nnix run github:utensils/mcp-nixos\nnix profile install github:utensils/mcp-nixos\n```\n\n## Development\n\n```bash\nnix develop          # Enter dev shell\nnix build            # Build package\npytest tests/        # Run tests\nruff check .         # Lint\nruff format .        # Format\nmypy mcp_nixos/      # Type check\n```\n\n## Acknowledgments\n\n- **[NixHub.io](https://www.nixhub.io)** - Package version history\n- **[search.nixos.org](https://search.nixos.org)** - Official NixOS search\n- **[FlakeHub](https://flakehub.com)** - Flake registry by Determinate Systems\n- **[Jetify](https://www.jetify.com)** - Creators of Devbox and NixHub\n- **[NuschtOS](https://github.com/NuschtOS/search)** - Static option search infrastructure powering Nixvim support\n- **[Nixvim](https://github.com/nix-community/nixvim)** - Neovim configuration framework for Nix\n\n## License\n\nMIT - Because sharing is caring.\n\n---\n\n*Created by James Brink. Maintained by mass̶o̶c̶h̶i̶s̶t̶s̶ enthusiasts who enjoy Nix.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Futensils%2Fmcp-nixos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Futensils%2Fmcp-nixos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Futensils%2Fmcp-nixos/lists"}