Paths Tree Generator

Servidor MCP Paths Tree Generator

Este repositório contém um servidor Model Context Protocol mínimo que expõe uma ferramenta – paths_to_tree – que converte uma lista plana de caminhos de sistema de arquivos em uma árvore de diretórios JSON.

---

Início rápido

1. Instalar dependências

É necessário um interpretador Python ≥ 3.9. É melhor trabalhar dentro de um ambiente virtual:

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

2. Executar o servidor

Existem duas maneiras comuns de iniciá-lo:

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

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

Quando iniciado com mcp dev, o MCP Inspector será aberto em http://localhost:6274/ e permitirá que você invoque a ferramenta pelo navegador.

API da ferramenta

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

Exemplo de invocação

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

Resposta

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

Usando o servidor no Cursor ou Claude Desktop

Adicione uma entrada à sua configuração MCP (exemplos mostrados para Cursor):

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

Reinicie o aplicativo host e a ferramenta paths_to_tree estará disponível para uso.

---

Sinta-se à vontade para estender o projeto com ferramentas adicionais (por exemplo, serialização para Markdown, filtragem, etc.) – basta decorar funções com @mcp.tool() e elas serão automaticamente expostas por meio do MCP.