gremlin_mcp

Aprendiendo de este tutorial de YouTube https://www.youtube.com/watch?v=io02ZM0ADqM Curso Completo de MCP para Principiantes Nota: Le pedí a Copilot u otro LLM que limpiara el código existente de las herramientas y añadiera otras que considerara útiles. Hay varias herramientas que deben usarse con precaución, ya que pueden modificar archivos y directorios. No he probado el uso de las herramientas adecuadamente. Necesito construir algo útil con este MCP y con las protecciones adecuadas.

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona a un agente capacidades de terminal y gestión de archivos: ejecutar comandos de shell/Python, buscar y leer archivos, y crear/editar/eliminar archivos y carpetas.

Construido sobre FastMCP.

Herramientas

El servidor expone 21 herramientas, agrupadas de la siguiente manera:

Ejecución de Shell / Python

Búsqueda y lectura

Archivos y carpetas

Related MCP server: emcp

Requisitos

• Python >= 3.13

• fastmcp >= 3.4.7

Instalación

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

Iniciar el servidor

El servidor se comunica a través de stdio, que es el transporte predeterminado de FastMCP. Inícielo desde la raíz del repositorio con cualquiera de:

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

Pruebas

1. Prueba de humo sin conexión (no se necesita cliente MCP)

python test.py

Esto importa el servidor, llama a todas las herramientas (creando y limpiando una carpeta temporal) e imprime un resumen de [PASS]/[FAIL] más un total.

2. Inspector web interactivo

fastmcp dev inspector src/gremlin_mcp/main.py

Abre el Inspector MCP en su navegador para que pueda explorar las herramientas, leer sus descripciones/ejemplos y llamarlas de forma interactiva.

Nota: fastmcp dev es un grupo de subcomandos, por lo que el subcomando inspector debe pasarse explícitamente (fastmcp dev src/... solo fallará).

3. Comprobaciones rápidas desde la línea de comandos

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

4. Conexión desde un cliente MCP

Apunte la configuración MCP de su editor/cliente al servidor a través de stdio, por ejemplo:

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

Ejemplos de llamadas a herramientas

Como las emitiría un agente:

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)

Estructura del proyecto

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

Nota de seguridad

run_command, python_code y python_file ejecutan código arbitrario. Solo exponga este servidor a agentes/clientes de confianza y considere ejecutarlo dentro de un entorno aislado o un directorio de trabajo restringido.