de en es ja ko ru zh

mcp-context

Name: mcp-context
Author: ericlimabr

by ericlimabr

Overview Schema Source Related Servers Discussions Admin

Local

mcp-context

Lokaler Model Context Protocol (MCP) Server mit semantischer Suche (RAG) über Code-Repositories. Stellt den Kontext mehrerer Projekte für externe KI-Clients bereit — Claude.ai, Gemini, Claude Code — und macht es überflüssig, den Kontext bei jeder Sitzung manuell erneut einzugeben.

Stack: Python · FastMCP · Qdrant · sentence-transformers · Next.js · Docker · Cloudflare Tunnel

Voraussetzungen

Stellen Sie sicher, dass die folgenden Elemente installiert sind, bevor Sie fortfahren:

Tool	Mindestversion	Überprüfung
Python	3.11	`python3 --version`
Docker	24.0	`docker --version`
Docker Compose	2.20	`docker compose version`
Node.js	18.0	`node --version`
npm	9.0	`npm --version`
Git	beliebig	`git --version`
cloudflared	beliebig	`cloudflared --version`

Ein Cloudflare-Konto mit einer aktiven Domain ist für die Remote-Konnektivität erforderlich (Phase 3).

Related MCP server: MCP Codebase RAG Server

Installation

# 1. Clone the repository
git clone https://github.com/ericlimabr/mcp-context.git
cd mcp-context

# 2. Copy the environment variables file
cp .env.example .env

# 3. Run setup — installs Python dependencies via uv and starts Qdrant
make setup

Hinweis zu GITHUB_TOKEN: Die .env-Datei enthält eine GITHUB_TOKEN-Variable für den Lesezugriff auf Repositories. Um diesen Token zu erhalten, gehen Sie in GitHub zu Settings > Developer settings > Personal access tokens. Generieren Sie einen neuen Token und fügen Sie ihn in Ihre .env-Datei ein.

Konfiguration

1. Umgebungsvariablen

Bearbeiten Sie die im vorherigen Schritt erstellte .env-Datei:

# Root path where your projects are stored on the machine
PROJECTS_ROOT=/home/your-user/projects

# Access password for the administrative panel
ADMIN_PASSWORD=choose-a-strong-password

2. Cloudflare Tunnel konfigurieren

# Authenticate cloudflared with your Cloudflare account
cloudflared tunnel login

# Create the permanent tunnel
cloudflared tunnel create mcp-context

# Associate with your subdomain (replace yourdomain.com)
cloudflared tunnel route dns mcp-context mcp.yourdomain.com

Erstellen Sie cloudflared/config.yml im Projektstammverzeichnis (diese Datei wird von git ignoriert). Ersetzen Sie <id> durch die UUID, die vom oben genannten tunnel create-Befehl ausgegeben wurde:

tunnel: mcp-context
credentials-file: /home/your-user/.cloudflared/<id>.json

ingress:
  - hostname: mcp.yourdomain.com
    service: http://localhost:17800
  - service: http_status:404

3. Frontend erstellen

Dieser Schritt ist nur einmal erforderlich. Er erstellt das Next.js-Projekt und entfernt automatisch das interne .git/:

make frontend-setup

4. Das erste Projekt indizieren

Öffnen Sie das Frontend, fügen Sie einen Projektpfad hinzu und starten Sie die Indizierung:

make frontend
# Access http://localhost:17801

Oder führen Sie den Indexer direkt über das Terminal aus:

make index

Lokal ausführen (Entwicklung)

Um den MCP-Server mit automatischem Neuladen zu starten (empfohlen während der Entwicklung):

make dev

Dies startet Qdrant, den Cloudflare Tunnel und den MCP-Server mit aktiviertem Hot-Reload. Der Server startet bei jeder Dateiänderung in server/ automatisch neu.

Um alle Dienste im Hintergrund zu starten (MCP-Server, Frontend, Tunnel, Qdrant):

make server-dev

Verfügbare Dienste:

Dienst	URL
MCP-Server	http://localhost:17800
Frontend (Admin + Dashboard)	http://localhost:17801
Qdrant (API)	http://localhost:17810

Echtzeit-Logs sind verfügbar unter logs/:

tail -f logs/server.log    # MCP server
tail -f logs/frontend.log  # frontend
tail -f logs/tunnel.log    # Cloudflare Tunnel
make qdrant-logs           # Qdrant

Um alles zu stoppen:

make stop

Lokale Bereitstellung (alle Dienste in Containern)

Um das Projekt vollständig containerisiert auszuführen — nützlich, um die Produktionsumgebung zu simulieren oder alles zusammen mit Docker zu starten:

# First time: build the images
make prod-build

# Start all containers
make prod-up

# Stop everything
make prod-down

# Real-time logs
make prod-logs

Warnung: Stellen Sie sicher, dass PROJECTS_ROOT in .env auf das korrekte Verzeichnis zeigt, bevor Sie prod-up ausführen. Der MCP-Server-Container bindet diesen Pfad ein, um auf lokale Dateien zuzugreifen.

Make-Befehle

Befehl	Beschreibung
`make setup`	Erster Durchlauf: installiert Abhängigkeiten via uv und startet Qdrant
`make frontend-setup`	Erstellt das Next.js-Projekt in `apps/frontend/` (einmalig)
`make dev`	Startet Qdrant + Tunnel + MCP-Server mit automatischem Neuladen
`make server-dev`	Startet alle Dienste im Hintergrund
`make stop`	Stoppt alle Entwicklungsdienste
`make server`	Startet nur den MCP-Server (Port 17800)
`make frontend`	Startet nur das Next.js-Frontend (Port 17801)
`make tunnel`	Startet nur den Cloudflare Tunnel
`make index`	Führt den Indizierungs-Worker aus
`make qdrant-up`	Startet Qdrant via Docker Compose
`make qdrant-down`	Stoppt Qdrant
`make qdrant-logs`	Qdrant-Logs in Echtzeit
`make prod-build`	Build aller Docker-Images
`make prod-up`	Startet alle Container
`make prod-down`	Stoppt alle Container
`make prod-logs`	Logs aller Container in Echtzeit

Repository-Struktur

mcp-context/
├── server/                  # MCP Server (FastMCP/SSE, port 17800)
│   ├── main.py              # Entrypoint and MCP configuration
│   ├── tools/               # MCP tool definitions (planned)
│   ├── resources/           # MCP resource definitions (planned)
│   └── embeddings.py        # Local embedding model loading (planned)
├── indexer/                 # Project indexing worker (planned)
│   ├── worker.py            # Orchestrates indexing
│   ├── chunker.py           # Function-scope chunking
│   └── qdrant_client.py     # Qdrant client abstraction
├── apps/
│   └── frontend/            # Next.js app — admin panel + dashboard (port 17801)
│                            # Generated by make frontend-setup
├── cloudflared/             # Cloudflare Tunnel config (gitignored)
│   └── config.yml
├── docs/
│   ├── ARCHITECTURE.md      # Detailed system architecture
│   ├── DECISIONS.md         # Architecture decisions
│   ├── ENDPOINTS.md         # Endpoints documentation
│   └── ROADMAP.md           # Implementation phases
├── logs/                    # Service logs in dev (gitignored)
├── .pids/                   # Process PIDs in dev (gitignored)
├── qdrant_data/             # Persisted Qdrant data (gitignored)
├── config.json              # Project configuration (gitignored)
├── .env                     # Environment variables (gitignored)
├── .env.example             # Environment variables template
├── docker-compose.yml       # Qdrant for development
├── docker-compose.prod.yml  # All services for local deploy
├── Makefile                 # Command shortcuts
├── pyproject.toml           # Python project and dependencies (uv)
├── CONTEXT.md               # Project context for LLMs
└── README.md                # This file

Bekannte Einschränkungen

Der Server ist darauf angewiesen, dass der lokale Rechner eingeschaltet ist, um via Cloudflare Tunnel remote zu funktionieren
Der Qdrant-Index spiegelt den Zustand des Codes zum Zeitpunkt der letzten Indizierung wider — konfigurieren Sie einen post-commit-Hook, um den Index nach jedem Commit automatisch aktuell zu halten
Binärdateien, Bilder und Assets werden nicht indiziert
Das Embedding-Modell (jina-embeddings-v2-base-code, ~160 MB) wird beim ersten Start automatisch via sentence-transformers heruntergeladen

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

mcp A
ai.llmse
Public MCP server for the LLM Search Engine
Search RAG Systems Developer Tools
102
gread A
io.github.NitroRCr
An MCP server that gives your AI access to the source code and docs of all public github repos
Version Control Code Analysis Documentation Access
5364
Meeba Brain A
io.github.meemoprasad
Repository knowledge graph MCP server for codebase understanding and debugging.
Code Analysis Developer Tools
51
Mirror Memory MCP Server
io.github.Tr1ckyMag1ca1
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
Knowledge & Memory Search Note Taking
2

Related MCP Servers

embecode
Code Analysis Developer Tools Search
jdtzmn
A
license
A
quality
D
maintenance
Local-first MCP server for semantic + keyword hybrid code search. Zero external services, no API keys required.
Updated 7 months ago (2026-02-27 19:55 UTC)
2
MIT
MCP Codebase RAG Server
RAG Systems Search Code Analysis
di5rupt0r
F
license
A
quality
D
maintenance
Provides semantic vector search over local codebases via MCP, enabling hybrid search (dense + sparse + RRF) for any MCP client like GitHub Copilot or Claude Desktop.
Updated 6 months ago (2026-03-23 01:30 UTC)
5
8
-
CodeLens MCP
Code Analysis Search
devprashant19
F
license
Not graded
quality
B
maintenance
A local MCP server that enables LLM clients like Claude to perform semantic code search and answer questions about a codebase using tree-sitter parsing and sqlite-vec vector storage.
Updated 2 months ago (2026-07-26 17:34 UTC)
-
cba
davidgeorgehope
F
license
Not graded
quality
D
maintenance
MCP server for semantic code search and explanation. Allows AI agents to search, ask questions, and manage memory about a codebase with local embeddings and LLM integration.
Updated 7 months ago (2026-03-02 11:24 UTC)
-

mcp-context

Voraussetzungen

Installation

Konfiguration

1. Umgebungsvariablen

2. Cloudflare Tunnel konfigurieren

3. Frontend erstellen

4. Das erste Projekt indizieren

Lokal ausführen (Entwicklung)

Lokale Bereitstellung (alle Dienste in Containern)

Make-Befehle

Repository-Struktur

Bekannte Einschränkungen

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

embecode

MCP Codebase RAG Server

CodeLens MCP

cba