Skip to content
MCP server

Keyspoor

Offline secret scanning MCP server that returns redacted findings to coding agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.1.4
Listing updated
1 day ago

About Keyspoor

Keyspoor is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

Keyspoor is a Rust secret scanner distributed as a CLI, a library and a read-only MCP server. Started with a project root, the MCP server gives an agent two tools for scanning text or paths, with progress reporting, cancellation and bounded previews. Reports list rule, byte location, fingerprint and explanation but never the raw secret or a source snippet.

Detection runs locally: no provider requests, no credential validation and no revocation. Beyond plain files it can read staged Git changes, local history, UTF-16 text, single-layer Base64 and ZIP, tar or gzip archives within depth and size budgets. Output can be JSON, JSONL or SARIF, and exit codes separate clean (0), findings (1) and errors or incomplete scans (2).

The authors are explicit that MCP only makes tools available; enforcement should come from a Git hook or a required CI check, and a GitHub Action is provided. It is Apache-2.0 licensed at version 0.1.4, with a Rust API that may change before 1.0.

Install

Run in a terminal

claude mcp add keyspoor -- npx -y keyspoor

Add to claude_desktop_config.json

{
  "mcpServers": {
    "keyspoor": {
      "command": "npx",
      "args": [
        "-y",
        "keyspoor"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "keyspoor": {
      "command": "npx",
      "args": [
        "-y",
        "keyspoor"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "keyspoor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "keyspoor"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "keyspoor": {
      "command": "npx",
      "args": [
        "-y",
        "keyspoor"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "keyspoor": {
      "command": "npx",
      "args": [
        "-y",
        "keyspoor"
      ]
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

scan_text
Scans supplied text for secrets and returns redacted findings.
scan_paths
Scans files or paths under the configured root and returns redacted findings.

What it does

Agent scan tools
Read-only scan_text and scan_paths over MCP, scoped to a chosen root.
Redacted reports
Findings show rules and locations, never the secret value.
Git-aware scanning
Covers staged changes and locally reachable history with baselines.
Archive expansion
Looks inside ZIP, tar and gzip files without writing members to disk.
CI and hooks
GitHub Action and staged hook block commits that contain findings.
Rust library
Reusable Engine with custom JSON rules, keyword gates and allowlists.

Good for

  • Give a coding agent a safe way to check text for leaked credentials
  • Block commits containing secrets with a staged Git hook
  • Fail pull requests in CI and upload a SARIF report
  • Audit local Git history for old secrets

Pricing

Open source

Apache-2.0; free to use

Prices change. Check majiayu000.github.io before you buy.

Keyspoor FAQ

Does it send my code anywhere?

No. Scanning is offline; only first-time npm or npx installation needs registry access.

Will the agent always scan before committing?

No. The docs say MCP does not guarantee a scan; use a Git hook or required CI check to enforce it.

How is it installed?

Through cargo, npm (Node.js 20+) or Homebrew; the npm package bundles native binaries.

What licence is it under?

Apache-2.0.

Is Keyspoor free?

Yes. Keyspoor is open source, so you can use and self-host it for free.

How do I add Keyspoor to Claude Code?

Run this command in your terminal: claude mcp add keyspoor -- npx -y keyspoor

What are the best alternatives to Keyspoor?

The closest alternatives to Keyspoor are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Keyspoor

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools