MCPO - MCP over HTTP Proxy für Cursor
Ein MCP (Model Context Protocol) Server, der Cursor-Tools als HTTP-API bereitstellt und mit Open WebUI und n8n integriert werden kann.
Features
- 🚀 MCP Server mit Cursor-Tools (codebase_search, file operations, etc.)
- 🌐 HTTP-API via mcpo (MCP over HTTP Proxy)
- 🐳 Podman/Docker Support für einfaches Deployment
- 🔧 PowerShell Install-Script für Windows
- 📡 Open WebUI Integration ready
- 🔄 n8n kompatibel für Workflow-Automation
Quick Start
Windows (PowerShell)
# Installations-Script ausführen
.\mcpo_install.ps1
Das Script:
- Prüft Voraussetzungen (Podman, Node.js)
- Installiert Dependencies
- Startet Podman-Compose als Daemon
- MCP Server ist unter
http://localhost:8000verfügbar
Manuell
# 1. Dependencies installieren
npm install
# 2. Environment konfigurieren
cp .env.example .env
# .env bearbeiten und API-Keys setzen
# 3. Mit Podman starten
podman-compose up -d
# 4. Status prüfen
podman-compose ps
Konfiguration
Environment Variables
Kopiere .env.example nach .env und passe an:
# MCPO Configuration
MCPO_PORT=8000
MCPO_API_KEY=dein-geheimer-api-key-hier
# Workspace (wird als Volume gemountet)
WORKSPACE_PATH=D:\workspace\pvs
# MCP Server
MCP_SERVER_NAME=cursor-mcp
MCP_SERVER_VERSION=1.0.0
API-Key generieren
# PowerShell: Zufälligen API-Key generieren
-join ((48..57) + (65..90) + (97..122) | Get-Random -Count 32 | ForEach-Object {[char]$_})
Verwendung
API-Endpunkte
Nach dem Start:
- API Base:
http://localhost:8000 - OpenAPI Docs:
http://localhost:8000/docs - Health Check:
http://localhost:8000/health
Open WebUI Integration
- Open WebUI → Admin → Settings → External Tools
- MCP Server hinzufügen:
- Type:
MCP (Streamable HTTP) - URL:
http://localhost:8000(oder Docker-Hostname) - API Key: Wert aus
MCPO_API_KEYin.env
- Type:
- Tools aktivieren und speichern
n8n Integration
HTTP Request Node in n8n:
{
"method": "POST",
"url": "http://localhost:8000/api/tools/codebase_search",
"headers": {
"Authorization": "Bearer DEIN_API_KEY",
"Content-Type": "application/json"
},
"body": {
"query": "Wie funktioniert die Patient-Suche?",
"target_directories": []
}
}
Verfügbare Tools
codebase_search
Semantische Suche im Codebase.
Input:
{
"query": "Wie wird die Patient-Suche implementiert?",
"target_directories": ["src/main/java"]
}
file_read
Liest Dateien aus dem Workspace.
Input:
{
"path": "src/main/java/de/bbajor/pvs/patient/service/PatientService.java"
}
file_list
Listet Verzeichnisinhalte.
Input:
{
"directory": "src/main/java",
"recursive": false
}
Entwicklung
Lokale Entwicklung (ohne Docker)
# 1. Node.js Dependencies
npm install
# 2. MCP Server starten
node cursor-mcp-server.js
# 3. In anderem Terminal: mcpo starten
uvx mcpo --port 8000 --api-key "test-key" -- node cursor-mcp-server.js
Logs ansehen
# Podman-Compose Logs
podman-compose logs -f mcp-cursor-proxy
# Nur MCP Server Logs
podman-compose logs -f mcp-server
Container neu bauen
podman-compose build --no-cache
podman-compose up -d
Troubleshooting
Port bereits belegt
# Prüfen, was Port 8000 nutzt
netstat -ano | findstr :8000
# In .env anderen Port setzen (z.B. 8001)
Podman nicht gefunden
# Prüfen, ob Podman installiert ist
podman --version
# Falls nicht: Podman Desktop installieren
# https://podman-desktop.io/
MCP Server startet nicht
# Logs prüfen
podman-compose logs mcp-server
# Container-Shell öffnen
podman-compose exec mcp-server sh
# Manuell testen
node cursor-mcp-server.js
Projekt-Struktur
mcpo/
├── cursor-mcp-server.js # MCP Server (Node.js)
├── package.json # Node.js Dependencies
├── Dockerfile # MCP Server Container
├── podman-compose.yml # Podman-Compose Config
├── mcpo_install.ps1 # Installations-Script
├── .env.example # Environment Template
├── .gitignore
└── README.md
Lizenz
MIT License - siehe LICENSE Datei (falls vorhanden)
Beitragen
PRs sind willkommen! Bitte:
- Fork erstellen
- Feature-Branch (
cursor/feature/mein-feature) - Commit & Push
- PR gegen
mainerstellen