@cognisos/fabric-mcp

Fabric MCP server for Claude Code, Cursor, Windsurf, and any other client that speaks the Model Context Protocol. Builds a local LMDB-backed knowledge graph of your codebase and exposes it as tools.

Tools

• Code intelligence (9 tools): fabric_index, fabric_reindex, fabric_query, fabric_slice, fabric_impact, fabric_contracts, fabric_staleness, fabric_recent_changes, fabric_explain — tree-sitter-parsed graph over your codebase.
• Governance & context (4 tools): fabric_debt, fabric_context_gen, fabric_govern, fabric_govern_add — team rules, tech-debt tracking, auto-generated CLAUDE.md / .cursorrules / copilot-instructions.md.
• Cloud sync (3 tools): fabric_sync_now, fabric_list_snapshots, fabric_pull — LMDB graph backup, listing, and cross-device restore.
• Status (1 tool): fabric_status — indexer health + per-type node/edge counts.

Install (one command)

npx -y @cognisos/fabric-mcp setup

That command opens your browser, signs you in at cognisos.ai, stores an API key in your OS keychain, and registers Fabric as a local stdio MCP in Claude Code. Restart Claude Code, type /mcp, and the tools are available.

How it works

• Indexer tools spawn a local Rust binary that reads your code, parses it with tree-sitter, and builds a local LMDB knowledge graph at ~/.fabric/index. Your code never leaves your machine.
• Cloud sync uploads snapshots of your local store (graph only, no source) to your Fabric account for disaster recovery and cross-device restore.
• API key is stored in your OS keychain (macOS Keychain, GNOME Keyring, Windows Credential Manager) via @napi-rs/keyring. Never written to disk in plaintext.

Platforms

Subcommands

npx @cognisos/fabric-mcp          # run the MCP server in stdio mode (what Claude Code spawns)
npx @cognisos/fabric-mcp setup    # one-time install: OAuth + keychain + claude mcp add
npx @cognisos/fabric-mcp login    # re-auth (opens browser again, updates keychain)
npx @cognisos/fabric-mcp logout   # wipe keychain entry
npx @cognisos/fabric-mcp doctor   # environment health check

Manual install (for CI / headless)

If setup can't open a browser (SSH, tmux, container):

# 1. Get an API key from https://cognisos.ai/dashboard → Developer
# 2. Register the MCP with the key passed as an env var
claude mcp add fabric -s user \
  -e FABRIC_API_KEY=lim_xxxxxxxxxxxxx \
  -- npx -y @cognisos/fabric-mcp

License

Proprietary — © Cognisos, Inc.