gremlin_mcp

Lernen von diesem YouTube-Tutorial https://www.youtube.com/watch?v=io02ZM0ADqM MCP Full Course for Beginners Hinweis: Ich habe Copilot oder eine andere KI gebeten, den vorhandenen Code für Tools zu bereinigen und andere hinzuzufügen, die es für nützlich hielt. Es gibt mehrere Tools, die mit Vorsicht verwendet werden sollten, da sie Dateien und Verzeichnisse ändern können. Ich habe die Tool-Nutzung nicht richtig getestet. Ich muss etwas Nützliches mit diesem MCP und mit geeigneten Schutzmaßnahmen bauen.

Ein MCP-Server (Model Context Protocol), der einem Agenten Terminal- und Dateiverwaltungsfunktionen bietet: Shell-/Python-Befehle ausführen, Dateien suchen und lesen sowie Dateien und Ordner erstellen/bearbeiten/löschen.

Basiert auf FastMCP.

Werkzeuge

Der Server stellt 21 Werkzeuge bereit, gruppiert wie folgt:

Shell / Python-Ausführung

Suchen & Lesen

Dateien & Ordner

Related MCP server: emcp

Anforderungen

• Python >= 3.13

• fastmcp >= 3.4.7

Installation

uv sync            # recommended
# or
python -m pip install -e .

Server starten

Der Server kommuniziert über stdio, den Standardtransport von FastMCP. Starten Sie ihn aus dem Repository-Stammverzeichnis mit einem der folgenden Befehle:

uv run python -m gremlin_mcp.main
python test.py serve
python start_gremlin_mcp_server.py

Testen

1. Offline-Smoke-Test (kein MCP-Client erforderlich)

python test.py

Dies importiert den Server, ruft jedes Werkzeug auf (erstellt und bereinigt einen temporären Ordner) und gibt eine [PASS]/[FAIL]-Zusammenfassung sowie eine Gesamtzahl aus.

2. Interaktiver Web-Inspektor

fastmcp dev inspector src/gremlin_mcp/main.py

Öffnet den MCP-Inspektor in Ihrem Browser, sodass Sie die Werkzeuge durchsuchen, ihre Beschreibungen/Beispiele lesen und sie interaktiv aufrufen können.

Hinweis: fastmcp dev ist eine Unterbefehlsgruppe, daher muss der Unterbefehl inspector explizit übergeben werden (fastmcp dev src/... allein wird fehlschlagen).

3. Schnelle CLI-Überprüfungen

fastmcp inspect src/gremlin_mcp/main.py    # server info + tool summary
fastmcp list   src/gremlin_mcp/main.py     # just the tool names

4. Verbindung von einem MCP-Client herstellen

Weisen Sie die MCP-Konfiguration Ihres Editors/Clients über stdio auf den Server hin, zum Beispiel:

{
  "mcpServers": {
    "gremlin-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "gremlin_mcp.main"]
    }
  }
}

Beispielhafte Werkzeugaufrufe

Wie ein Agent sie ausgeben würde:

list_dir(path="src")
search_text(pattern="TODO", directory="src")
read_file(file="pyproject.toml")
write_file(file="hello.py", content="print('hi')")
python_code(code="print(6 * 7)")          # -> exit=0 / 42
replace_in_file(path="config.py", old="DEBUG = True", new="DEBUG = False")
tree(path=".", depth=2)

Projektstruktur

src/gremlin_mcp/
├── __init__.py
├── tools.py   # all tool definitions (21 tools)
└── main.py    # FastMCP server entry point
test.py        # offline smoke test / optional server launcher
start_gremlin_mcp_server.py   # minimal "run the server" launcher

Sicherheitshinweis

run_command, python_code und python_file führen beliebigen Code aus. Setzen Sie diesen Server nur Agenten/Clients aus, denen Sie vertrauen, und erwägen Sie, ihn in einer Sandbox oder einem eingeschränkten Arbeitsverzeichnis auszuführen.