Which integrations are available for this server?

Exposes MCP server tools via HTTP API for workflow automation, enabling n8n to perform codebase searches, file operations, and other MCP tools through HTTP Request nodes.

How do I use MCPO - MCP over HTTP Proxy?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCPO - MCP over HTTP Proxy search the codebase for patient search functionality" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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:8000 verfü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_KEY in .env
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 main erstellen

MCPO - MCP over HTTP Proxy

MCPO - MCP over HTTP Proxy für Cursor

Features

Quick Start

Windows (PowerShell)

Manuell

Konfiguration

Environment Variables

API-Key generieren

Verwendung

API-Endpunkte

Open WebUI Integration

n8n Integration

Verfügbare Tools

codebase_search

file_read

file_list

Entwicklung

Lokale Entwicklung (ohne Docker)

Logs ansehen

Container neu bauen

Troubleshooting

Port bereits belegt

Podman nicht gefunden

MCP Server startet nicht

Projekt-Struktur

Lizenz

Beitragen

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API