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 は一度もリリースされていません — 使用しないでください）。

任意の 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/ にあります：

ライセンス

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