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、Apple + Android UI 阶梯、Vulkan/OpenGL 路径、App Store / Play 合规性，以及 wwn-* 打过补丁的软件仓库。WWN = Wawona。

这不是 mcp-nixos。主机契约的思路相同（代理主机通过 stdio 启动一个 PATH 二进制文件），但语料库、工具和包均为 Wawona 专用。没有公开 URL / Streamable HTTP 传输（mcp.wawona.io 从未发布——请勿使用它）。

可与任何能够启动 stdio 服务器的 MCP 主机配合使用（Cursor、VS Code、Claude Desktop、Windsurf、Antigravity、Zed、自定义代理……）。Cursor 只是其中一个客户端——并非唯一。Zed 使用 context_servers 而非 mcpServers（参见 docs/usage.md）。

为 MCP 主机安装一个 PATH 二进制文件——不要将 nix run --refresh 接入编辑器配置（Zed 的约 60 秒 initialize 超时 → “上下文服务器请求超时”）。

快速开始

# 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 中）

请使用绝对路径（通过 Dock 启动的 Zed 没有 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