Skip to main content
Glama
README.md
# 🚀 Sistema de Gestão MCP com SQLite

Este projeto é um servidor de gerenciamento de clientes e produtos baseado no protocolo MCP (Model Context Protocol).

## 🛠️ Pré-requisitos
- [Python 3.10+](https://www.python.org/)
- [uv](https://astral.sh/uv/) (Gerenciador de pacotes)
- [Claude Desktop](https://claude.com/download)

<br>

## 📦 Instalação
1. Clone o repositório:
   ```bash
   git clone https://github.com/mateus-gondev/MCP-PIE.git
   cd MCP-PIE
   ```
2. Instale as dependências:
    ```bash
    uv sync
    ```

<br>

## ⚙️ Configuração no Claude Desktop

**1. Instalação do Claude Desktop**<br>
Acesse o site oficial da Anthropic([Clade Desktop Download](https://claude.com/download)) e baixe a versão para Windows. Instale o aplicativo e faça login com sua conta gratuita.

**2. Localização do Arquivo de Configuração**<br>
O Claude Desktop utiliza um arquivo JSON para saber quais servidores MCP ele deve iniciar.

**Passo a Passo:**

- **Windows:** Pressione **Win + R** e cole: **%APPDATA%\Claude\claude_desktop_config.json**<br>
ou<br> 
- **Procure no Claude Desktop** Var em -> 3 barraras -> Arquivos -> Configurações -> Desenvolvedor -> Editar Config

Abra o arquivo claude_desktop_config.json e adicione a configuração abaixo. **Atenção:** Substitua o caminho pelo local onde você salvou este projeto.

```bash
{
  "mcpServers": {
    "Gestao-MCP": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/CAMINHO/PARA/SEU/PROJETO",
        "run",
        "server.py"
      ]
    }
  }
}
```

NOTA: Clicando com botão direito na raiz do projeto "Copia Caminho" ou copiando URL das pastas. **Importante** substituir a barra contraria "\" por "/" "//".

---
<br>

## 📖 Documentação Adicional
Utilize esse guia para visualizar as **Tools** (Funções ou Ferramentas) que tem disponivel no projeto
* ([🔌 Guia de Testes](https://github.com/mateus-gondev/MCP-PIE/blob/main/docs/TOOLS.md))



<br>

Projeto ainda em **Desenvolvimento**...

TDQS

B3.4/5.0

Scored across 9 tools

Disambiguation5/5

Each tool has a clear and distinct purpose: two address update methods, search, CRUD for clients and products, and a list-all tool. No overlapping functionality.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern in lowercase with underscores (e.g., cadastrar_cliente, editar_produto). The pattern is uniform across the set.

Tool Count5/5

9 tools is well-scoped for a management system covering clients and products, providing core operations without being excessive.

Completeness2/5

Missing operations include delete client and individual get for both clients (by ID) and products. The search only covers clients by CEP/CPF, leaving product search absent. These gaps could hinder common workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues