Scaffold MCP Server

@Beer-Bears

Basic information

About Scaffold MCP Server

Scaffold is a specialized RAG system that transforms entire codebase into a living knowledge graph, capturing the deep structural relationships between files, classes, and functions. This provides AI agents with the crucial context to accurately understand, maintain, and reason a

#graph-rag #rag #llm #knowledge-graph #code-analysis #generative-ai#context-retrieval

Scaffold MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Scaffold": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--name",
        "scaffold-mcp",
        "-p",
        "8000:8080",
        "-v",
        "${PROJECT_PATH}:/app/codebase",
        "-e",
        "CHROMA_SERVER_HOST=${CHROMA_SERVER_HOST}",
        "-e",
        "CHROMA_SERVER_PORT=${CHROMA_SERVER_PORT}",
        "-e",
        "CHROMA_COLLECTION_NAME=${CHROMA_COLLECTION_NAME}",
        "-e",
        "NEO4J_USER=${NEO4J_USER}",
        "-e",
        "NEO4J_PASSWORD=${NEO4J_PASSWORD}",
        "-e",
        "NEO4J_URI=${NEO4J_URI}",
        "-t",
        "ghcr.io/beer-bears/scaffold:latest"
      ],
      "env": {
        "CHROMA_SERVER_HOST": "<CHROMA_HOST>",
        "CHROMA_SERVER_PORT": "<CHROMA_PORT>",
        "CHROMA_COLLECTION_NAME": "scaffold_data",
        "NEO4J_USER": "<NEO4J_USER>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
        "NEO4J_URI": "bolt://<NEO4J_USER>:<NEO4J_PASSWORD>@<NEO4J_HOST>:NEO4J_PORT>",
        "PROJECT_PATH": "<PATH_TO_YOUR_PROJECT>"
      }
    }
  }
}

Scaffold MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Scaffold?

Scaffold is a specialized Retrieval-Augmented Generation (RAG) system that provides deep, structural understanding of large codebases to LLMs and AI agents. It transforms source code into a living knowledge graph, enabling precise, context-aware interactions. This MCP server allows clients like Cursor to interface with the Scaffold knowledge graph to construct, maintain, and reason about complex software projects.

How to use Scaffold?

First, run the required database dependencies (Neo4j and ChromaDB) in Docker on a shared network. Then, configure your MCP client (e.g., mcp.json in Cursor) with a Docker command and environment variables that point to your databases and the absolute path to your codebase. The server exposes a single tool get_code_entity_information that can be invoked from the AI agent.

Key features of Scaffold

Graph-Based RAG: Represents codebases as interconnected graphs of files, classes, and functions.
Living Knowledge Base: Keeps the AI's understanding synchronized with code structure.
Eliminate Context Blindness: Provides project-specific architecture and logic to agents.
Precise Context Injection: Delivers targeted information about code entities.
Hybrid Search: Combines graph traversal with vector search for comprehensive context.

Use cases of Scaffold

Ask an AI agent what a specific class (e.g., PaymentService) does.
Find the source code and relationships of a particular function (e.g., save_graph_to_db).
Understand what a code entity like FileNode is and which other methods use it.

Frequently asked questions

What are the runtime dependencies for Scaffold?

Scaffold requires Neo4j and ChromaDB to be running in Docker on a shared network before the MCP server container starts.

How do I fix a "Connection Refused" error?

Ensure the database containers (`scaffold-neo4j` and `scaffold-chromadb`) are running and all three containers are on the same Docker network. Also verify that the user, password, and hostnames in the environment variables match the running databases.

Why does the server report "File not found"?

The `PROJECT_PATH` environment variable must be an absolute path on your host machine. Relative paths (like `.` or `~/`) may not work correctly.

Where does Scaffold store its data?

Data is stored in the Neo4j graph database and ChromaDB vector store, both running in Docker containers with persistent volumes (`neo4j_data` and `chroma_data`).

What transport does Scaffold use?

Scaffold runs as a Docker container that exposes a port (8000 mapped to container port 8080) for MCP communication over HTTP.

Comments

More Developer Tools MCP servers

LastPing

Know when your AI agents, cron jobs and CI pipelines fail, stall or go quiet. Your agent sets up monitors from a plain description, tells you what is broken and why, reads run history and traces, and writes notes on inci

Screen Browser

Turn a plain-language guide into a narrated walkthrough video of your deployed web app. Your coding agent can write the guide from the source and bring back the MP4.

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott