Gemdex MCP Server

io.github.nikships/gemdex

Repository Registry

What is the Gemdex MCP server?

Persistent memory layer for AI coding agents: save, recall, update via Gemini plus LanceDB

How to install Gemdex

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GEMINI_API_KEY
required
secret
Google AI Studio key for local mode, or the exact value 'local' for on-device MLX text embeddings. Not needed in remote mode.
GEMDEX_MODE
Memory backend: embedded local LanceDB or a self-hosted Gemdex Server
LANCEDB_PATH
Directory for the embedded LanceDB store
EMBEDDING_MODEL
Gemini text embedding model
GEMDEX_REMOTE_URL
Gemdex Server root URL (required in remote mode)
GEMDEX_REMOTE_TOKEN
secret
Gemdex Server bearer token (required in remote mode)
GEMDEX_REMOTE_NAME
Human-readable name for the remote server
GEMDEX_TRUST_RANKING
Re-rank recall results by recorded worked/failed/stale outcomes

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gemdex": {
      "command": "npx",
      "args": [
        "-y",
        "gemdex-mcp",
        "-y",
        "gemdex-mcp@1.0.47"
      ],
      "env": {
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "GEMDEX_MODE": "<YOUR_GEMDEX_MODE>",
        "LANCEDB_PATH": "<YOUR_LANCEDB_PATH>",
        "EMBEDDING_MODEL": "<YOUR_EMBEDDING_MODEL>",
        "GEMDEX_REMOTE_URL": "<YOUR_GEMDEX_REMOTE_URL>",
        "GEMDEX_REMOTE_TOKEN": "<YOUR_GEMDEX_REMOTE_TOKEN>",
        "GEMDEX_REMOTE_NAME": "<YOUR_GEMDEX_REMOTE_NAME>",
        "GEMDEX_TRUST_RANKING": "<YOUR_GEMDEX_TRUST_RANKING>"
      }
    }
  }
}