Regen

monofuel/Regen

3.3

If you are the rightful owner of Regen and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server is a specialized server designed to facilitate communication and interaction with machine learning models, providing a structured interface for model management and query execution.

Tools
2
Resources
0
Prompts
0

Regen 🗃️

📚 A fast, lightweight document indexing tool that loads files, chunks them, and indexes with embeddings

✨ Features:

  • 🚀 Fast parallel processing with Nim

  • 🔍 Semantic search using embeddings

  • 💾 No database required - uses flatty for binary serialization

  • 📁 Works with git repos and local folders

  • 🧠 Uses Ollama for local embeddings (nomic-embed-text)

  • Warning: file contents will be sent to the embedding api. defaults to local ollama at localhost:11434/v1 using nomic-embed-text.

  • depending on your files and your environment, you may want to adjust the blacklisted filenames and extensions.

📋 TODO

  • 🌐 OpenAPI server interface
  • 🔌 MCP (Model Context Protocol) server support
  • implement CORS configuration
  • support query - document embeddings in addition to similarity search
  • properly support multiple embedding models (currently only supports 1 in config json)

⚡ Quick start

  • ensure you have ripgrep installed locally!

1) Configure indexing

  • Add paths to track:
    • Folders: regen --add-folder-index /path/to/folder
    • Git repos: regen --add-repo-index /path/to/repo
  • Build indexes: regen --index-all

Notes:

  • Config lives at ~/.regen/config.json and is created on first run.
  • An API key is generated automatically. View it with: regen --show-api-key

2) Start a server

  • OpenAPI server (HTTP):
    • Start: regen --server [port] [address]
    • Defaults: port 8095, address 0.0.0.0
  • MCP server (HTTP):
    • Start: regen --mcp-server [port] [address]
    • Defaults: port 8096, address 0.0.0.0

Authentication:

  • Protected endpoints/tools require Authorization: Bearer <API_KEY> where <API_KEY> is from regen --show-api-key.

3) Tools (available via both OpenAPI and MCP)

  • ripgrep_search: keyword/regex search across all configured indexes
    • Inputs: pattern (string), caseSensitive (bool, default true), maxResults (int, default 100)
  • embedding_search: semantic similarity search using embeddings
    • Inputs: query (string), maxResults (int, default 10), model (string, defaults to configured model), extensions (optional seq of file extensions)

HTTP endpoints (OpenAPI server):

  • Health: GET / (no auth)
  • OpenAPI spec: GET /openapi.json (no auth)
  • Ripgrep: POST /search/ripgrep (Bearer auth)
  • Embedding: POST /search/embedding (Bearer auth)

Example (ripgrep over HTTP):

curl -H "Authorization: Bearer $(regen --show-api-key | sed -n 's/API Key: //p')" \
     -H "Content-Type: application/json" \
     -d '{"pattern":"TODO","caseSensitive":true,"maxResults":50}' \
     http://localhost:8095/search/ripgrep