LINZA MCP Server

by semiotronikaio.github.Semiotronika/LINZA-MCPv0.2.2

Review-gated sidecar for Markdown workspaces: indexes notes into SQLite and proposes links, domains and memory with evidence, editing files only after review.

5Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained58d ago

Install LINZA MCP server

claude mcp add linza -e LINZA_EMBED_KEY='<linza-embed-key>' -- uvx linza-mcp

{
  "mcpServers": {
    "linza": {
      "command": "uvx",
      "args": [
        "linza-mcp"
      ],
      "env": {
        "LINZA_EMBED_KEY": "<linza-embed-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "linza": {
      "command": "uvx",
      "args": [
        "linza-mcp"
      ],
      "env": {
        "LINZA_EMBED_KEY": "<linza-embed-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "linza": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "linza-mcp"
      ],
      "env": {
        "LINZA_EMBED_KEY": "<linza-embed-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "linza": {
      "command": "uvx",
      "args": [
        "linza-mcp"
      ],
      "env": {
        "LINZA_EMBED_KEY": "<linza-embed-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
LINZA_VAULT	—	—	Absolute path to the Markdown workspace or vault LINZA may index. Defaults to ./vault.
LINZA_EMBED_PROVIDER	—	—	Embedding provider. Allowed values: lmstudio, openai, ollama. Default: lmstudio.
LINZA_EMBED_URL	—	—	Embedding API base URL when LINZA_EMBED_PROVIDER is lmstudio, openai, or ollama.
LINZA_EMBED_MODEL	—	—	Embedding model name.
LINZA_EMBED_KEY	—	yes	Optional embedding API key.
LINZA_BRIDGE_THRESHOLD	—	—	Semantic bridge threshold as a floating-point string. Default: 0.55.
LINZA_MAX_BRIDGE_PAIRS	—	—	Maximum note pairs for semantic bridge rebuilds. Default: 1000000. Use 0 to disable the guard.
LINZA_DEFAULT_PROFILE	—	—	Default search profile name. Defaults to general.
LINZA_LANGUAGE	—	—	User-facing guide language. Allowed values: auto, en, ru. Default: auto.

Freshness

Maintained — last maintenance signal 58d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-13 · 58d ago · GitHub
Latest release
2026-06-01 · 4mo ago · GitHub · v0.2.2
Package published
no data · npm/PyPI
Registry entry updated
2026-06-01 · 4mo ago · official registry · v0.2.2

FAQ

›How do I install the LINZA MCP server in Claude Code?

Run: claude mcp add linza -e LINZA_EMBED_KEY='<linza-embed-key>' -- uvx linza-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does LINZA require an API key?

Yes. It expects LINZA_EMBED_KEY, of which 1 is a secret.

›Can I use LINZA as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is LINZA in the official MCP registry?

Yes, as io.github.Semiotronika/LINZA-MCP.