Skip to main content
Glama
deenesjakoruzh
Wawona

WWN-MCP

by Wawona
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

WWN-MCP

MCP nix (ubuntu-latest) nix (macos-latest)

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/:

Лицензия

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

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Contextual MCP Server by ContextualAI

    Contextual MCP Serverofficial

    ContextualAI
    F
    license
    C
    quality
    D
    maintenance
    A Model Context Protocol server that provides Retrieval-Augmented Generation capabilities using Contextual AI, enabling AI interfaces like Cursor IDE and Claude Desktop to query domain-specific knowledge with context-aware responses and source citations.
    1
    21
    -

  • MCP-RAGNAR

    bixentemal
    A
    license
    Not graded
    quality
    D
    maintenance
    A local RAG server that enables document indexing and sentence window retrieval across multiple file formats like PDF, MD, and DOCX. It supports both local Hugging Face models and OpenAI embeddings for efficient context-aware querying through the Model Context Protocol.
    GPL 3.0