midos-mcp

MidOS MCP Community Library — Wissen, Fähigkeiten und Forschung als MCP-Tools.

Einmal installieren, mit jedem beliebigen KI-Client verbinden.

Installation

pip install midos-mcp

Anforderung: Die MidOS-Wissensdatenbank muss lokal verfügbar sein. Setzen Sie die Umgebungsvariable MIDOS_ROOT auf Ihr MidOS-Installationsverzeichnis (das Verzeichnis, das knowledge/ und modules/ enthält).

export MIDOS_ROOT=/path/to/midos

Schnellstart

# Start server (stdio — default for Claude Code, Cursor, etc.)
midos-mcp serve

# Start with HTTP transport
midos-mcp serve --http

# Generate config for your AI client
midos-mcp config --generate claude
midos-mcp config --generate cursor

# Check health
midos-mcp health

Befehle

midos-mcp serve

Startet den MCP-Server mit Ihrem bevorzugten Transport.

midos-mcp serve              # stdio (default)
midos-mcp serve --http       # Streamable HTTP on 127.0.0.1:8419
midos-mcp serve --sse        # Legacy SSE transport
midos-mcp serve --http --host 0.0.0.0 --port 9000

midos-mcp config

Generiert eine sofort kopierbare JSON-Konfiguration für jeden unterstützten MCP-Client.

midos-mcp config --generate claude    # Claude Desktop / Claude Code
midos-mcp config --generate cursor    # Cursor IDE
midos-mcp config --generate cline     # Cline (VS Code)
midos-mcp config --generate windsurf  # Windsurf IDE
midos-mcp config --generate continue  # Continue.dev
midos-mcp config --generate zed       # Zed Editor
midos-mcp config --generate opencode  # OpenCode
midos-mcp config --generate http      # Generic HTTP client

# Write to file
midos-mcp config --generate claude -o mcp-config.json

midos-mcp health

Überprüft den Serverstatus: Statistiken der Wissensdatenbank, Status des Vektorspeichers, Abhängigkeiten.

midos-mcp health          # Human-readable output
midos-mcp health --json   # JSON output for scripts

midos-mcp keys

Verwaltet API-Schlüssel für eine abgestufte Zugriffskontrolle.

midos-mcp keys generate --name "my-app" --tier dev
midos-mcp keys list
midos-mcp keys revoke midos_sk_abc

Stufen: dev (kostenlos), pro ($10/Monat), admin.

Konfiguration

Umgebungsvariablen

Root-Erkennung

Der Server lokalisiert die MidOS-Wissensdatenbank wie folgt:

1. MIDOS_ROOT Umgebungsvariable (empfohlen)

2. Auto-Erkennung: Sucht vom Paketstandort aus aufwärts nach CLAUDE.md + knowledge/

3. Fallback: Aktuelles Arbeitsverzeichnis

Wenn Sie über pip installiert haben, findet die Auto-Erkennung die Wissensdatenbank nicht. Entweder:

# Option A: Clone the repo and point to it
git clone https://github.com/MidOSresearch/midos.git
export MIDOS_ROOT=./midos

# Option B: Point to an existing MidOS directory
export MIDOS_ROOT=/path/to/your/midos

Überprüfen Sie dies mit midos-mcp health — es zeigt den erkannten Root-Pfad und die Wissensanzahl an.

Unterstützte Clients

Optionale Abhängigkeiten

# Vector store support (LanceDB + embeddings)
pip install midos-mcp[vector]

# Development tools
pip install midos-mcp[dev]

Was ist enthalten

MidOS stellt 68 MCP-Tools in 2 Stufen bereit:

Fähigkeiten

• Wissen — Durchsuchen Sie über 46.000 kuratierte Chunks über alle Domänen hinweg (vollständiger Inhalt, keine Kürzung)

• Fähigkeiten — 119 wiederverwendbare Muster über 16+ Technologie-Stacks hinweg

• EUREKA — 383 validierte Verbesserungen mit gemessenem ROI

• Wahrheit — 50 verifizierte Patches und Korrekturen

• SOTA — 140 hochmoderne Konvergenz-Obergrenzen

• Vektorsuche — Semantische Suche via LanceDB + Gemini Embeddings (3072-d)

Ratenbegrenzungen

Ungültige oder abgelaufene API-Schlüssel fallen automatisch auf die Dev-Stufe zurück.

Anforderungen

• Python 3.10+

• FastMCP 2.x

• MidOS-Wissensdatenbank (lokal)

Lizenz

MIT