# Keyspoor

> Keyspoor is an open-source MCP server for security. Offline secret scanning MCP server that returns redacted findings to coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://majiayu000.github.io/keyspoor/
- **Repository:** https://github.com/majiayu000/keyspoor
- **MCP Registry name:** io.github.majiayu000/keyspoor
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add keyspoor -- npx -y keyspoor
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/keyspoor
