smgt/mcp-nixos
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
4 commits 1 branch 0 tags 127 KiB
  • Go 96.8%
  • Nix 3.2%
Find a file
Exact
Simon Gate ea93975e1b
All checks were successful
CI / test (push) Successful in 1m3s
Details
fix lint errors
2026-06-25 23:13:15 +02:00
.forgejo/workflows add ci 2026-06-25 23:05:09 +02:00
docs/superpowers discover elastic search aliases dynamically 2026-06-25 22:57:10 +02:00
channel_test.go discover elastic search aliases dynamically 2026-06-25 22:57:10 +02:00
config.go discover elastic search aliases dynamically 2026-06-25 22:57:10 +02:00
docs_sources_test.go Initial import 2026-06-25 22:10:33 +02:00
flake.lock Initial import 2026-06-25 22:10:33 +02:00
flake.nix Initial import 2026-06-25 22:10:33 +02:00
go.mod Initial import 2026-06-25 22:10:33 +02:00
go.sum Initial import 2026-06-25 22:10:33 +02:00
http.go fix lint errors 2026-06-25 23:13:15 +02:00
main.go Initial import 2026-06-25 22:10:33 +02:00
main_test.go Initial import 2026-06-25 22:10:33 +02:00
nixhub_test.go Initial import 2026-06-25 22:10:33 +02:00
opencode.json Initial import 2026-06-25 22:10:33 +02:00
README.md Initial import 2026-06-25 22:10:33 +02:00
routing_test.go Initial import 2026-06-25 22:10:33 +02:00
server.go discover elastic search aliases dynamically 2026-06-25 22:57:10 +02:00
server_test.go Initial import 2026-06-25 22:10:33 +02:00
sources.go fix lint errors 2026-06-25 23:13:15 +02:00
util.go fix lint errors 2026-06-25 23:13:15 +02:00
util_test.go Initial import 2026-06-25 22:10:33 +02:00
version.go Initial import 2026-06-25 22:10:33 +02:00

README.md

mcp-nixos

mcp-nixos is a Go Model Context Protocol server for accurate NixOS, nixpkgs, Home Manager, nix-darwin, FlakeHub, Nixvim, Noogle, NixHub, nix.dev, NixOS Wiki, binary cache, and /nix/store queries.

This is a Go rewrite of the Python mcp-nixos server, using github.com/mark3labs/mcp-go like mcp-godoc.

Usage

go run .

Transport flags:

mcp-nixos --transport stdio
mcp-nixos --transport sse --addr 127.0.0.1:8000
mcp-nixos --transport http --addr 127.0.0.1:8000

Python-compatible environment defaults are also supported:

MCP_NIXOS_TRANSPORT=http MCP_NIXOS_HOST=127.0.0.1 MCP_NIXOS_PORT=8000 mcp-nixos

Tools

nix

Unified query tool:

nix(action, query, source, type, channel, limit, version, system)

Actions: search, info, stats, browse, channels, flake-inputs, cache, store.

Sources: nixos, home-manager, darwin, flakes, flakehub, nixvim, wiki, nix-dev, noogle, nixhub.

nix_versions

Package version history from NixHub:

nix_versions(package, version, limit)

Development

go test ./...
go run . --transport stdio
nix build
nix flake check

License

MIT. See LICENSE if present in downstream packaging.