MCP-Server

Ein modularer Model Context Protocol (MCP)-Server, der mit FastAPI erstellt wurde und Tools für LLM-Interaktionen bereitstellt.

Funktionen

• Modulare Architektur - Jedes Tool ist leicht wartbar

• Dateioperationen - Lesen, Schreiben, Anhängen, Ersetzen und Einfügen von Text in Dateien

• Websuche - Durchsuchen des Live-Webs mittels DDGS

• URL-Abruf - Scrapen und Zusammenfassen von Webinhalten

• Befehlsausführung - Ausführen von Shell-Befehlen in einer Sandbox-Umgebung

• Strenge Isolierung - Bubblewrap-Sandbox mit temporärem /tmp

Related MCP server: mcp-toolkit

Tools

Installation

# Clone the repository
git clone <repository-url>
cd mcp_server

# Install dependencies using uv
uv sync

Verwendung

# Start the server
python main.py

Der Server startet unter http://0.0.0.0:8000.

Architektur

mcp_server/
├── main.py              # FastAPI application entry point
├── tools.json           # Tool definitions (JSON schema)
└── tools/               # Tool implementations
    ├── __init__.py      # Exports all handlers
    ├── add.py           # Math operations
    ├── today.py         # Date/time
    ├── web_search.py    # Web search
    ├── fetch_content.py # URL scraping
    ├── files.py         # All file operations
    └── run_command.py   # Shell command execution

Sandbox-Konfiguration

Das Tool run_command verwendet Bubblewrap zur Isolierung:

• Schreibgeschütztes Root-Dateisystem (--ro-bind / /)

• Temporäres Verzeichnis (--tmpfs /tmp)

• Beschreibbares Ressourcenverzeichnis (--bind resources resources)

• DNS-Auflösung aktiviert (keine /etc-Einschränkung)

Haftungsausschluss

Dieses Projekt wurde mit Unterstützung von Qwen 3.6 entwickelt, einem großen Sprachmodell des Tongyi Lab der Alibaba Group. Während KI bei der Codegenerierung, Dokumentation und dem Refactoring geholfen hat, wurden alle technischen Entscheidungen und endgültigen Implementierungen vom menschlichen Entwickler überprüft und validiert.

Lizenz

MIT-Lizenz