Paths Tree Generator

Servidor MCP Paths Tree Generator

Este repositorio contiene un servidor mínimo de Protocolo de Contexto de Modelo que expone una herramienta – paths_to_tree – que convierte una lista plana de rutas de sistema de archivos en un árbol de directorios JSON.

---

Inicio rápido

1. Instalar dependencias

Se requiere un intérprete de Python ≥ 3.9. Es mejor trabajar dentro de un entorno virtual:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Ejecutar el servidor

Hay dos formas comunes de iniciarlo:

# a) Development mode – auto-reload & web inspector
mcp dev main.py

# b) Plain stdio mode – good for Cursor / Claude Desktop integrations
python main.py

Cuando se inicia con mcp dev, el Inspector MCP se abrirá en http://localhost:6274/ y le permitirá invocar la herramienta desde el navegador.

API de la herramienta

paths_to_tree(paths: list[str]) -> str

Ejemplo de invocación

[
  "config/webpack.config.js",
  "components/Modal",
  "components/Form",
  "components/Table",
  "pages/home",
  "pages/app",
  "pages/help",
  "package.json",
  "package-lock.json"
]

Respuesta

project-root
├── components
│   ├── Form
│   ├── Modal
│   └── Table
├── config
│   └── webpack.config.js
├── pages
│   ├── app
│   ├── help
│   └── home
├── package-lock.json
└── package.json

Uso del servidor en Cursor o Claude Desktop

Agregue una entrada a su configuración MCP (ejemplos mostrados para Cursor):

{
  "mcpServers": {
    "paths-tree": {
      "command": "/absolute/path/to/python",
      "args": ["/absolute/path/to/main.py"]
    }
  }
}

Reinicie su aplicación host y la herramienta paths_to_tree estará disponible para su uso.

---

Siéntase libre de extender el proyecto con herramientas adicionales (por ejemplo, serialización a Markdown, filtrado, etc.) – solo decore funciones con @mcp.tool() y se expondrán automáticamente a través de MCP.