Skip to main content
Glama

reprox-mcp

reprox-mcp is a TypeScript MCP server that lets coding agents search persistent repository memory created by cliper.

Reprox reads the persistent Local JSON memory created by Cliper and exposes it to MCP clients without inventing repository facts.

Tools

Tool

Use it when

Returns

search_memory

You need context for a question or task.

Matching memories grouped by retrieval category.

list_gaps

You need known risks or incomplete areas.

All gap summaries, high severity first.

get_gap

You need full context for one gap.

The gap and every memory it references.

get_related

You need memories connected to a known memory.

Outgoing and incoming relationship neighbors.

get_architecture

You need a structural repository overview.

All architecture and repository memories.

get_timeline

You need change or release history.

Commit, release, and timeline memories, newest first.

Related MCP server: codemem

Quickstart

Build and link or install the package, then ensure the target repository has been initialized:

cliper init
reprox mcp --path /path/to/repository

If repository memory is missing, the server responds with: Repository memory is not initialized; run cliper init first.

Codex configuration

Add this to ~/.codex/config.toml:

[mcp_servers.reprox]
command = "reprox"
args = ["mcp", "--path", "/absolute/path/to/repository"]

Omit --path to use the server process's current working directory.

Development

npm install
npm run build
npm run pack-clean

Available Tools

6 tools
get_architectureA

Call when you need a broad structural overview of the repository. Returns every architecture and repository memory.

Inputs: no named parameters.

get_gapA

Call when you need the full context for one known gap. Returns that gap and every memory it explicitly references.

Inputs: id (required).

get_timelineA

Call when you need repository history, releases, or recent change context. Returns commit, release, and timeline memories ordered newest first.

Inputs: no named parameters.

list_gapsA

Call when you want to find known missing, risky, or incomplete parts of the repository. Returns all gap memories ordered by severity with their location.

Inputs: no named parameters.

search_memoryA

Call when you need repository context relevant to a question or task. Returns matching memories grouped by architecture, files, dependencies, packages, repository, commits, and gaps.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: search for context, list/get gaps, get related memories, get architecture, and get timeline. Overlap with the generic search is acceptable because the specific getters are clearly scoped to particular memory types.

    Naming Consistency4/5

    All tool names use snake_case and an imperative verb prefix like search_, list_, or get_. The only minor deviation is get_related, which uses an adjective rather than a clear noun object, but the pattern remains highly predictable.

    Tool Count5/5

    With six tools, the server is well-scoped for a repository-context memory retrieval service. Each tool covers a meaningful access pattern without unnecessary redundancy or bloat.

    Completeness5/5

    The tool surface covers the full read-only retrieval lifecycle: broad search, specific gap lookup, relationship traversal, architecture overview, and timeline/history access. No significant missing operation is apparent for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI coding agents to retrieve and manage code context with hybrid search, project memory, and observability via MCP tools.
      30
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides persistent, searchable memory across coding projects and machines, letting agents record and retrieve projects, reusable assets, sessions, decisions, commits, and handoffs via MCP.
      3
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables coding agents to retrieve compact, cited repository maps through MCP tools such as search, symbol inspection, flow investigation, and deep context loading.
      1
      Apache 2.0