Gestao-MCP
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