# scree

> scree is an open-source MCP server for knowledge and memory. Local semantic and keyword search over the markdown in a repo or notes folder. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Website:** https://scree.jrpko.dev
- **Repository:** https://github.com/jrapakko/scree
- **MCP Registry name:** io.github.jrapakko/scree
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-15

## About

scree is a single static Go binary that gives Claude Code search over READMEs, design docs, ADRs, agent instructions and notes, though not source code. It splits each markdown file by heading, embeds the pieces through OpenRouter with zero data retention requested, and keeps chunks, vectors and a keyword index in a SQLite file on your machine.

The agent calls search_docs and gets hits with a path, heading trail and line range, so it reads only those lines instead of whole files. Matching is by meaning and, for identifiers such as PURGE_OLD_RECORDS or PageFetcher, by exact words too. Without an API key it still indexes for keyword search.

The site gives rough running costs: about $0.0025 per MB of markdown to index once, only changed files re-embedded, and 13 to 20 MB of idle memory per process. A repo is only indexed if its own .mcp.json names scree mcp, and the README warns that approving a project server means trusting that repo. It is MIT licensed.

## Features

- **Heading-level chunks:** Splits markdown by heading so hits are short sections.
- **Hybrid retrieval:** Combines vector search with an exact-word keyword index.
- **Line-range hits:** Each hit has a path, heading trail and lines to read.
- **Local index:** Stores everything in a SQLite file per folder; the index can be rebuilt.
- **Doctor command:** Lists files that would be indexed or ignored and estimates cost.
- **Repo opt-in:** Indexes only repos whose .mcp.json names the server.

## Good for

- Find the design doc section that answers a question worded differently
- Search ADRs and notes without loading whole files
- Index a notes folder outside any repo
- Look up an identifier mentioned in docs

## Install

### Claude Code (Terminal)

```sh
claude mcp add scree --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- docker run -i --rm -e OPENROUTER_API_KEY ghcr.io/jrapakko/scree:0.4.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "scree": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENROUTER_API_KEY",
        "ghcr.io/jrapakko/scree:0.4.1"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "scree": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENROUTER_API_KEY",
        "ghcr.io/jrapakko/scree:0.4.1"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "scree": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENROUTER_API_KEY",
        "ghcr.io/jrapakko/scree:0.4.1"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "scree": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENROUTER_API_KEY",
        "ghcr.io/jrapakko/scree:0.4.1"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "scree": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENROUTER_API_KEY",
        "ghcr.io/jrapakko/scree:0.4.1"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search_docs`: Searches indexed markdown and returns hits with paths and line ranges.

## FAQ

### Does it index code?

No, only markdown.

### What does it need?

An OpenRouter API key for embeddings, saved with scree key.

### What does indexing cost?

About $0.0025 per MB of markdown, once; only changed files are re-embedded.

### What is the licence?

MIT.

### Is scree free?

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

### How do I add scree to Claude Code?

Run this command in your terminal: claude mcp add scree --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- docker run -i --rm -e OPENROUTER_API_KEY ghcr.io/jrapakko/scree:0.4.1

### What are the best alternatives to scree?

The closest alternatives to scree 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.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

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