1. Conduid
  2. Developer Tools
  3. Codebase RAG
MCP server · Developer Tools

Codebase RAG

by · github.com/allentcm/mcp-codebase-rag

A self-updating, symbol-aware vector index and reference graph of a codebase, exposed over MCP, so any MCP-compatible LLM agent can understand a whole repository cheaply instead of burning tokens on dozens of grep and glob calls.

Unclaimed last commit 6 months ago rag
InstallView source
48Fair

Scored yesterday · breakdown

About Codebase RAG

Codebase RAG is an MCP server published by allentcm in the Developer Tools category: a self-updating, symbol-aware vector index and reference graph of a codebase, exposed over MCP, so any MCP-compatible LLM agent can understand a whole repository cheaply instead of burning tokens on dozens of grep and glob calls. It has been installed 0 times through Conduid.

The repository has 8 stars and 0 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx codebase-rag

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Codebase RAG

Powered by Claude · Grounded in docs

I know everything about Codebase RAG. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

Codebase RAG MCP Server

This MCP server provides semantic codebase search and file retrieval using embeddings and a PostgreSQL database. It exposes tools for searching code, listing files, and retrieving file contents.

Features

  • Semantic Code Search: Uses Voyage embedding model to convert queries into vectors and search code snippets by similarity.
  • File Listing: Lists all tracked files in the codebase.
  • File Content Retrieval: Fetches the full content of a file by filename.

Tools

  • search_codebase

    • Returns code snippets relevant to the query.
    • Inputs:
      • query (string): Search terms

  • get_files

    • Lists all files in the codebase.

  • get_file_content

    • Returns the content of the specified file.
    • Inputs:
      • filename (string): Filename

Configuration

Getting a Voyage API Key

  1. Sign up for a Voyage API account
  2. Generate your API key from the dashboard

Environment Variables

  • DATABASE_URL: PostgreSQL connection string.
  • VOYAGE_API_KEY: API key for embedding model.
  • EMBEDDING_TABLE: Table name for code embeddings.
  • TRACKING_TABLE: Table name for file tracking.

Docker

{
  "mcpServers": {
    "codebase-rag": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "VOYAGE_API_KEY",
        "-e",
        "EMBEDDING_TABLE",
        "-e",
        "TRACKING_TABLE",
        "-p",
        "8080:8080",
        "allentcm/mcp-codebase-rag:1.0.0"
      ],
      "env": {
        "DATABASE_URL": "postgres://cocoindex:cocoindex@localhost/cocoindex",
        "VOYAGE_API_KEY": "voyage_api_key",
        "EMBEDDING_TABLE": "codebase__code_embeddings",
        "TRACKING_TABLE": "codebase__cocoindex_tracking"
      }
    }
  }
}

License

This MCP server is licensed under the MIT License. You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

README mirrored from the source repository yesterday. The original is authoritative.

Questions

About Codebase RAG

How do I install Codebase RAG?

Run npx codebase-rag, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Codebase RAG safe to use with an AI agent?

Its trust score is 48 out of 100 (fair). It passes 0 of 1 static security checks; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Codebase RAG still maintained?

The last commit was 6 months ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.