Skip to main content
Glama
alfmorais

sap-mcp-simulation

by alfmorais
README.md
# SAP MCP Simulation

Este projeto implementa um servidor baseado no protocolo **MCP (Model Context Protocol)** para simular e intermediar integrações com o SAP (via OData), expondo ferramentas automatizadas para agentes e assistentes de Inteligência Artificial.

## 🚀 Como Rodar o Projeto

Este projeto utiliza o gerenciador de pacotes **uv** para máxima performance e isolamento do ambiente Python.

### Pré-requisitos
Certifique-se de ter o `uv` instalado. Caso não tenha, instale com o comando `curl -LsSf https://astral.sh/uv/install.sh | sh` no macOS/Linux.

### Executando o Servidor MCP
Para rodar a aplicação principal utilizando o ambiente virtual gerenciado pelo `uv`, execute o comando `uv run src/main.py` no seu terminal.

### Executando os Testes e Cobertura
Para validar a aplicação e garantir que tudo está funcionando perfeitamente com 100% de cobertura, execute o comando `uv run pytest --cov=src`.

---

## 🔌 Conectando ao VS Code (Extensão Cline)

Para permitir que a extensão **Cline** no VS Code utilize as ferramentas deste servidor MCP, adicione a configuração do servidor ao arquivo de configurações de MCP do Cline.

### Passo a Passo

1. Abra o arquivo de configuração de MCP do Cline de acordo com o seu sistema operacional:
   * **macOS:** `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
   * **Windows:** `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
   * **Linux:** `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev\settings\cline_mcp_settings.json`

2. Insira a configuração do servidor apontando para o caminho absoluto do seu projeto conforme o modelo abaixo:

```json
{
  "mcpServers": {
    "sap-mcp-simulation": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/CAMINHO/ABSOLUTO/PARA/sap-mcp-simulation",
        "src/main.py"
      ]
    }
  }
}
```

⚠️ Importante: Substitua /CAMINHO/ABSOLUTO/PARA/sap-mcp-simulation pelo caminho real da pasta do projeto na sua máquina.