WWN-MCP

Wawona MCP – ein lokaler Embeddings-RAG- und Stdio-Server für das Model Context Protocol, der jedem MCP-fähigen Agenten retrieval-gestütztes Wissen über den Wawona-Stack bietet: Wayland / Smithay / Weston / Niri, Apple- und Android-UI-Ebenen, Vulkan/OpenGL-Pfade, App-Store-/Play-Compliance und die wwn-*-Repos gepatchter Software. WWN = Wawona.

Das ist nicht mcp-nixos. Der Host-Vertrag ist dieselbe Idee (der Agent-Host startet eine PATH-Binärdatei über stdio), aber Korpus, Tools und Paket sind nur für Wawona. Es gibt keinen öffentlichen URL-/Streamable-HTTP-Transport (mcp.wawona.io wurde nie ausgeliefert – verwenden Sie es nicht).

Funktioniert mit jedem MCP-Host, der einen stdio-Server starten kann (Cursor, VS Code, Claude Desktop, Windsurf, Antigravity, Zed, benutzerdefinierte Agenten, …). Cursor ist ein Client – nicht der einzige. Zed verwendet context_servers anstelle von mcpServers (siehe docs/usage.md).

Installieren Sie eine PATH-Binärdatei für MCP-Hosts – integrieren Sie nix run --refresh nicht in die Editor-Konfiguration (das ~60s initialize-Timeout von Zed → „Zeitüberschreitung der Context-Server-Anfrage“).

Schnellstart

# Install once (recommended for Cursor / Zed / …)
nix profile install github:Wawona/WWN-MCP

# Terminal smoke (prints JSON / search hits and exits)
wwn-mcp info
wwn-mcp search "watchOS GPU"
# or: nix run github:Wawona/WWN-MCP#wwn-mcp -- info

# Bare `wwn-mcp` / `nix run …#wwn-mcp` on an interactive terminal prints MCP
# host setup help (Cursor + Zed examples) and exits. Your agent must spawn
# the process with piped stdin for the MCP server.

Cursor / VS Code-ähnliche Hosts (mcpServers)

{
  "mcpServers": {
    "wwn-mcp": { "command": "wwn-mcp", "args": [] }
  }
}

Zed (context_servers in ~/.config/zed/settings.json)

Verwenden Sie einen absoluten Pfad (ein über das Dock gestartetes Zed hat keinen Shell-PATH):

{
  "context_servers": {
    "wwn-mcp": {
      "command": "/Users/YOU/.nix-profile/bin/wwn-mcp",
      "args": [],
      "env": {}
    }
  }
}

Ohne Nix:

pip install -e ".[all]"
wwn-mcp index --knowledge
wwn-mcp info

Mit home-manager / dendritic:

programs.wwn-mcp.enable = true;

Siehe docs/deployment.md. Bei der ersten leeren DB indiziert serve automatisch das mitgelieferte knowledge/ im Hintergrund, sodass initialize nicht blockiert wird. Für lokale Schwester-Repos: wwn-mcp index --local-siblings (oder fetch und dann index).

Related MCP server: Contextual MCP Server

Dokumentation

Die gesamte Dokumentation befindet sich in docs/:

• Überblick & Architektur

• Korpus-Katalog

• MCP-Tools & Ressourcen

• Bereitstellung (home-manager / dendritic stdio)

• Verwendung (MCP-Host-Verdrahtung + lokale Entwicklung)

• Mitwirken

Lizenz

MIT – siehe LICENSE. Open Source. Drittanbieter-Dokumentation und -Quellen, die WWN-MCP indiziert, werden zur Laufzeit abgerufen und niemals in dieses Repository übernommen; ihre Lizenzhinweise werden in den Ergebniszitaten angezeigt.