WWN-MCP

Wawona MCP — un servidor del Model Context Protocol con RAG de incrustaciones locales + stdio que proporciona a cualquier agente compatible con MCP conocimiento respaldado por recuperación de la pila Wawona: Wayland / Smithay / Weston / Niri, escaleras de UI de Apple + Android, rutas de Vulkan/OpenGL, cumplimiento de App Store / Play y los repositorios de software parcheado wwn-*. WWN = Wawona.

Esto no es mcp-nixos. El contrato del host es la misma idea (el host del agente inicia un binario de PATH sobre stdio), pero el corpus, las herramientas y el paquete son exclusivos de Wawona. No hay URL pública / transporte HTTP Streamable (mcp.wawona.io nunca se publicó — no lo use).

Funciona con cualquier host MCP que pueda iniciar un servidor stdio (Cursor, VS Code, Claude Desktop, Windsurf, Antigravity, Zed, agentes personalizados, …). Cursor es un cliente — no el único. Zed usa context_servers en lugar de mcpServers (ver docs/usage.md).

Instala un binario de PATH para hosts MCP — no integres nix run --refresh en la configuración del editor (el tiempo de espera de initialize de ~60s de Zed → “Context server request timeout”).

Inicio rápido

# 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.

Hosts del tipo Cursor / VS Code (mcpServers)

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

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

Usa una ruta absoluta (Zed lanzado desde el Dock no tiene PATH de shell):

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

Sin Nix:

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

Con home-manager / dendritic:

programs.wwn-mcp.enable = true;

Ver docs/deployment.md. En la primera base de datos vacía, serve auto-indexa el knowledge/ incluido en segundo plano para que initialize no se bloquee. Para repos locales hermanos: wwn-mcp index --local-siblings (o fetch y luego index).

Related MCP server: Contextual MCP Server

Documentación

Toda la documentación está en docs/:

• Descripción general y arquitectura

• Catálogo del corpus

• Herramientas y recursos MCP

• Despliegue (home-manager / dendritic stdio)

• Uso (configuración de host MCP + desarrollo local)

• Contribuir

Licencia

MIT — ver LICENSE. Código abierto. La documentación y el código fuente de terceros que WWN-MCP indexa se obtienen en tiempo de ejecución y nunca se incluyen en este repositorio; sus avisos de licencia se muestran en las citas de los resultados.