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는 출시된 적이 없습니다 — 사용하지 마세요).

모든 MCP 호스트와 작동합니다. stdio 서버를 생성할 수 있는 호스트(Cursor, VS Code, Claude Desktop, Windsurf, Antigravity, Zed, 사용자 지정 에이전트, …). Cursor는 하나의 클라이언트입니다 — 유일한 것은 아닙니다. Zed는 mcpServers 대신 context_servers를 사용합니다 (docs/usage.md 참조).

MCP 호스트용 PATH 바이너리를 설치하세요 — nix run --refresh를 편집기 구성에 넣지 마세요(Zed의 ~60초 initialize 시간 초과 → “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 (~/.config/zed/settings.json의 context_servers)

절대 경로를 사용하세요(Dock에서 실행된 Zed에는 셸 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를 참조하세요. 첫 번째 빈 DB에서 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가 인덱싱하며 런타임에 가져오고 이 저장소에 번들되지 않습니다. 해당 라이선스 고지는 결과 인용에 표시됩니다.