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は1つのクライアントにすぎません — 唯一のクライアントではありません。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 (context_servers は ~/.config/zed/settings.json 内)

絶対パスを使用してください（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 がインデックスするサードパーティのドキュメントとソースは実行時に取得され、このリポジトリにベンダリングされることはありません。それらのライセンス表記は結果の引用に表示されます。