MCP Workspace Server

Ein leichtgewichtiger Python-MCP-Server, der KI-Agenten einen sicheren, strukturierten Zugriff auf Dateien innerhalb eines kontrollierten lokalen Workspace bietet.

Übersicht

KI-Agenten benötigen häufig Zugriff auf Projektkontext, der in lokalen Dateien gespeichert ist. Einem Agenten uneingeschränkten Dateisystemzugriff zu gewähren, stellt ein unnötiges Sicherheitsrisiko dar.

Dieses Projekt nutzt das Model Context Protocol (MCP), um eine kleine Reihe kontrollierter Workspace-Tools bereitzustellen und den Zugriff dabei auf ein konfiguriertes Verzeichnis zu beschränken.

Related MCP server: Files MCP Server

MCP-Tools

Der Server stellt drei Tools bereit:

list_workspace_files

Listet die Dateien auf, die im konfigurierten Workspace verfügbar sind.

read_text_file

Liest UTF-8-Textdateien mit konfigurierbaren Größenbegrenzungen.

search_text

Durchsucht Workspace-Dokumente und gibt übereinstimmende Dateinamen, Zeilennummern und Text zurück.

Sicherheit

Der Server prüft angeforderte Pfade gegen einen festgelegten Workspace-Root und verhindert Path Traversal außerhalb dieses Verzeichnisses.

Weitere Schutzmaßnahmen umfassen:

• Beschränkter Workspace-Zugriff

• Eingabevalidierung

• Dateigrößengrenzen

• UTF-8-Handhabung

• Schutz vor Path Traversal

• Automatisierte Sicherheitstests

Projektstruktur

mcp-workspace-server/
├── src/
│   └── mcp_workspace_server/
│       ├── __init__.py
│       └── server.py
├── tests/
│   └── test_paths.py
├── workspace/
│   └── example.txt
├── pyproject.toml
└── README.md