WWN-MCP

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/ 中：

• 概述与架构

• 语料库目录

• MCP 工具与资源

• 部署（home-manager / dendritic stdio）

• 用法（MCP 主机接入 + 本地开发）

• 参与贡献

许可证

MIT — 参见 LICENSE。开源。WWN-MCP 所索引的第三方文档和源代码在运行时获取，绝不会内置到本仓库中；其许可证声明会显示在结果引用中。