WWN-MCP

Wawona MCP — это локальный RAG на эмбеддингах + stdio-сервер Model Context Protocol, который предоставляет любому MCP-совместимому агенту поисковые знания о стеке Wawona: Wayland / Smithay / Weston / Niri, UI-лестницы Apple и Android, пути Vulkan/OpenGL, соответствие требованиям App Store / Play и репозитории пропатченного ПО wwn-*. WWN = Wawona.

Это не mcp-nixos. Контракт хоста — та же идея (хост агента запускает PATH-бинарник через stdio), но корпус, инструменты и пакет относятся только к Wawona. Нет публичного URL / транспорта Streamable HTTP (mcp.wawona.io никогда не выпускался — не используйте его).

Работает с любым MCP-хостом, который может запустить stdio-сервер (Cursor, VS Code, Claude Desktop, Windsurf, Antigravity, Zed, пользовательские агенты, …). Cursor — один из клиентов, но не единственный. Zed использует context_servers вместо mcpServers (см. docs/usage.md).

Установите PATH-бинарник для MCP-хостов — не прописывайте nix run --refresh в конфигурацию редактора (таймаут initialize у Zed ~60s → «Context server request timeout»).

Быстрый старт

# 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 (mcpServers)

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

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

Используйте абсолютный путь (Zed, запущенный из Dock, не имеет shell PATH):

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

Без Nix:

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

С home-manager / dendritic:

programs.wwn-mcp.enable = true;

См. docs/deployment.md. При первой пустой БД serve автоматически индексирует поставляемый knowledge/ в фоновом режиме, чтобы не блокировать initialize. Для локальных соседних репозиториев: wwn-mcp index --local-siblings (или fetch, затем index).

Related MCP server: Contextual MCP Server

Документация

Вся документация находится в docs/:

• Обзор и архитектура

• Каталог корпуса

• Инструменты и ресурсы MCP

• Развёртывание (home-manager / dendritic stdio)

• Использование (подключение MCP-хоста + локальная разработка)

• Участие

Лицензия

MIT — см. LICENSE. Открытый исходный код. Сторонняя документация и исходные коды, которые индексирует WWN-MCP, загружаются во время выполнения и никогда не добавляются в этот репозиторий; их уведомления о лицензиях отображаются в цитатах результатов.