Skip to main content
Glama
RaviTeja-438

ZAP RAG MCP Server

by RaviTeja-438
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

ZAP RAG MCP Server

Standalone Model Context Protocol (MCP) server that exposes only ZAP’s RAG search modes for other agents (Kilo, Cursor, Claude Desktop, Continue, etc.).

Works with the SQLite index built by the ZAP IntelliJ plugin (rag.db).

Tool

Description

zap_rag_status

DB health, chunk/embedding counts, models, modes

zap_rag_search

Semantic search: PLAIN / HYBRID / HYBRID_RERANK

Read-only. No write tools, no agent loop — retrieval only.

Modes

Mode

Behavior

Needs

PLAIN

Cosine over code-chunk embeddings

Index + embeddings

HYBRID

Weighted class summaries + code

Class summaries at index time

HYBRID_RERANK

Hybrid pool → LLM rerank

Chat API key

Related MCP server: NetApp AIDE MCP Server

Install

cd zap-rag-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

Environment

Variable

Required

Description

ZAP_DB_PATH

Yes

Absolute path to ZAP rag.db

ZAP_EMBEDDING_BASE_URL

Yes*

OpenAI-compatible embeddings base URL

ZAP_EMBEDDING_API_KEY

Yes*

API key (ollama ok for local)

ZAP_EMBEDDING_MODEL

Yes*

Must match model used when indexing

ZAP_CHAT_BASE_URL

Rerank

Chat completions base

ZAP_CHAT_API_KEY

Rerank

Chat API key

ZAP_CHAT_MODEL

Rerank

Chat model name

ZAP_RETRIEVAL_MODE

No

Default mode (PLAIN)

ZAP_TOP_K

No

Default top_k (10)

ZAP_PROJECT_PATH

No

Scope to this project path

ZAP_SEARCH_ENTIRE_DATABASE

No

true = no project filter

* Falls back to OPENAI_BASE_URL / OPENAI_API_KEY if set.

Find the DB path in IntelliJ: Settings → ZAP → Database path.

Run

$env:ZAP_DB_PATH = "C:\path\to\rag.db"
$env:ZAP_EMBEDDING_BASE_URL = "http://127.0.0.1:11434/v1"
$env:ZAP_EMBEDDING_API_KEY = "ollama"
$env:ZAP_EMBEDDING_MODEL = "nomic-embed-text"
python server.py

MCP over stdio (no HTTP port).

MCP host config (Kilo / Cursor / Claude Desktop)

See mcp.example.json. Example:

{
  "mcpServers": {
    "zap-rag": {
      "command": "C:\\path\\to\\zap-rag-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\zap-rag-mcp\\server.py"],
      "env": {
        "ZAP_DB_PATH": "C:\\path\\to\\rag.db",
        "ZAP_EMBEDDING_BASE_URL": "http://127.0.0.1:11434/v1",
        "ZAP_EMBEDDING_API_KEY": "ollama",
        "ZAP_EMBEDDING_MODEL": "nomic-embed-text"
      }
    }
  }
}

Agent skill

See .grok/skills/searching-zap-rag/SKILL.md (Anthropic Agent Skills: third-person description, progressive references/) for how coding agents should call the tools.

Related

License

Apache-2.0

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-context

    ericlimabr
    F
    license
    Not graded
    quality
    D
    maintenance
    Local MCP server that provides semantic search (RAG) over code repositories, enabling AI clients like Claude and Gemini to access project context without manual re-upload.
    -
  • NetApp AIDE MCP Server by NetApp

    NetApp AIDE MCP Serverofficial

    NetApp
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server that exposes NetApp AI Data Engine's RAG search for semantic document retrieval.
    28 PyPI
    BSD 3-Clause

  • Satori

    ham-zax
    A
    license
    Not graded
    quality
    B
    maintenance
    Agent-safe code retrieval MCP server that indexes repositories and provides semantic search, file navigation, call graph analysis, and bounded file reading tools for coding agents.
    2,846,509 npm
    3
    AGPL 3.0