mcp-gestao-os
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP — Gestão de Serviços e Ordens de Serviço
Servidor MCP em Python que expõe CRUD de Serviços (catálogo) e Ordens de Serviço (OS) para uso conversacional via Claude Desktop / Claude Code. Implementa o SPEC.md com o SDK oficial MCP (low-level Server, sem FastMCP), transporte streamable HTTP e persistência em SQLite.
Arquitetura (camadas)
src/gestao_os/
├── main.py # Entrypoint: ASGI (Starlette + uvicorn), streamable HTTP em /mcp
├── server.py # Montagem do Server MCP: instructions, list_tools, call_tool
├── database.py # SQLite: schema e transações (FKs ativas)
├── errors.py # AppError + códigos do contrato de erros (seção 7)
├── textutil.py # Normalização case/accent-insensitive (RN01, RN13)
├── models/ # Entidades: Servico, OrdemServico, OrdemServicoItem
├── repositories/ # Acesso a dados (SQL puro por entidade)
├── services/ # Regras de negócio (RN01–RN10)
└── tools/
├── definitions.py # As 13 tools MCP com inputSchema e descriptions (seções 5 e 6)
├── handlers.py # Validação de argumentos (RN12/RN15) e delegação aos services
└── validation.py # Helpers de validação: tipos, paginação (RN14), confirmação (RN12)Fluxo de uma tool call: server.call_tool → handlers (presença/tipo/confirmação) → services (regras de negócio, transação) → repositories (SQL) → JSON estruturado de volta ao cliente. Erros de negócio retornam {"erro": "<CODIGO>", "mensagem": "<pt-BR>"}.
Related MCP server: ServiceNow CMDB MCP Server
Requisitos
Python 3.11+
Dependências:
mcp>=1.27,starlette,uvicorn
Instalação e execução
pip install -e ".[dev]"
# inicia em http://127.0.0.1:8000/mcp (SQLite: .\gestao_os.db)
mcp-gestao-os
# opções
mcp-gestao-os --host 0.0.0.0 --port 8000 --db C:\dados\gestao_os.db(Equivalente: python -m gestao_os.main.)
Conectando o cliente
Claude Code:
claude mcp add --transport http gestao-os http://127.0.0.1:8000/mcpClaude Desktop: adicionar em Settings → Connectors (integração remota) apontando para http://127.0.0.1:8000/mcp, ou via proxy stdio no claude_desktop_config.json:
{
"mcpServers": {
"gestao-os": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://127.0.0.1:8000/mcp"]
}
}
}Testes
python -m pytestA suíte cobre as regras de negócio RN01–RN14: unicidade case/accent-insensitive, snapshot de preço, recálculo de valor_total, imutabilidade de OS concluída/cancelada, mínimo de 1 item, confirmação de operações destrutivas, paginação etc.
Tools expostas (13)
Grupo | Tools |
Serviços |
|
Ordens de Serviço |
|
Itens da OS |
|
Regras conversacionais (desambiguação por busca, confirmação de destrutivas, nunca presumir dados) estão embutidas nas instructions do servidor e nas descriptions das tools, conforme a seção 6 do SPEC.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage tickets, run agents and workflows, query tables, and search workspace knowledge.
Query, explore, and manage your databases through natural conversation.
AI-native ITSM and ESM platform. resolve IT and HR requests inside Slack and Teams.
Connect AI to Odoo ERP 14-20: search, create, update and manage records in natural language.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables natural language interaction with ServiceNow instances for managing incidents, changes, CMDB, service catalog, users, groups, and knowledge base via MCP.4131 npm1MIT
- AlicenseAqualityDmaintenanceConnects AI assistants to ServiceNow CMDB via natural language, enabling querying, dependency analysis, health auditing, CI lifecycle management, and configurable inspection.4031 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceConnects Microsoft Copilot Studio to ServiceNow Service Catalog, enabling users to search catalog items, fill Adaptive Card order forms, and place orders from within a Copilot Studio agent.1MIT
- FlicenseAqualityDmaintenanceEnables store operations including inventory and sales queries and automated replenishment ordering through natural language.3-