MCP Server de Sistema de Vendas
Este repositório contém o código-fonte de um sistema de vendas (Produtos, Clientes, Vendas, Itens de Venda) desenvolvido com Java, Spring Boot, AI Server, MCP Tools e PostgreSQL.
Tecnologias Utilizadas
Este projeto foi construído utilizando as seguintes tecnologias:
- Java 21: Linguagem de programação.
- Spring Boot 3.4.7: Framework para desenvolvimento de aplicações Java.
- Spring AI: Para funcionalidades de inteligência artificial (AI Server).
- MCP Tools: Ferramentas específicas do projeto.
- PostgreSQL: Banco de dados relacional.
- Maven: Ferramenta de automação de build e gerenciamento de dependências.
- Spring Data JPA: Para persistência de dados com o PostgreSQL.
- Spring Boot Starter Validation: Para validação de dados.
- Lombok: Para reduzir o código boilerplate.
Estrutura do Projeto
A estrutura do projeto segue o padrão de aplicações Spring Boot, com pacotes bem definidos para cada camada da aplicação:
src
├── main
│ ├── java
│ │ └── br
│ │ └── com
│ │ └── wm
│ │ └── springmcp
│ │ ├── SpringMcpApplication.java
│ │ ├── config
│ │ │ └── Config.java
│ │ ├── controller
│ │ │ ├── ClienteController.java
│ │ │ ├── ProdutoController.java
│ │ │ └── VendaController.java
│ │ ├── exception
│ │ │ └── GlobalExceptionHandler.java
│ │ ├── model
│ │ │ ├── Cliente.java
│ │ │ ├── ItensVenda.java
│ │ │ ├── Produto.java
│ │ │ └── Venda.java
│ │ ├── repository
│ │ │ ├── ClienteRepository.java
│ │ │ ├── ItensVendaRepository.java
│ │ │ ├── ProdutoRepository.java
│ │ │ └── VendaRepository.java
│ │ ├── service
│ │ │ ├── ClienteService.java
│ │ │ ├── ProdutoService.java
│ │ │ ├── VendaService.java
│ │ │ └── VendasAnalysisService.java
│ │ └── tools
│ │ └── VendasMcpTools.java
│ └── resources
│ └── application.properties
└── test
└── java
└── br
└── com
└── wm
└── springmcp
└── SpringMcpApplicationTests.java
Pré-requisitos
Para executar este projeto, você precisará ter o seguinte software instalado em sua máquina:
- Java Development Kit (JDK) 21 ou superior.
- Apache Maven.
- PostgreSQL.
Configuração do Banco de Dados
-
Certifique-se de ter uma instância do PostgreSQL em execução.
-
Crie um novo banco de dados para o projeto (ex:
spring_mcp_db). -
Atualize as configurações de conexão com o banco de dados no arquivo
src/main/resources/application.properties:spring.datasource.url=jdbc:postgresql://localhost:5432/spring_mcp_db spring.datasource.username=seu_usuario spring.datasource.password=sua_senha spring.jpa.hibernate.ddl-auto=update spring.jpa.show-sql=trueSubstitua
seu_usuarioesua_senhapelas suas credenciais do PostgreSQL.
Como Executar a Aplicação
-
Clone o repositório:
git clone https://github.com/williammian/spring-mcp.git cd spring-mcp -
Compile o projeto usando Maven:
mvn clean install -
Execute a aplicação Spring Boot:
mvn spring-boot:runA aplicação estará disponível em
http://localhost:8080.
Endpoints da API
O sistema expõe os seguintes endpoints RESTful:
Clientes
GET /clientes: Lista todos os clientes.GET /clientes/{id}: Retorna um cliente pelo ID.POST /clientes: Cria um novo cliente.PUT /clientes/{id}: Atualiza um cliente existente.DELETE /clientes/{id}: Exclui um cliente.
Produtos
GET /produtos: Lista todos os produtos.GET /produtos/{id}: Retorna um produto pelo ID.POST /produtos: Cria um novo produto.PUT /produtos/{id}: Atualiza um produto existente.DELETE /produtos/{id}: Exclui um produto.
Vendas
GET /vendas: Lista todas as vendas.GET /vendas/{id}: Retorna uma venda pelo ID.POST /vendas: Cria uma nova venda.PUT /vendas/{id}: Atualiza uma venda existente.DELETE /vendas/{id}: Exclui uma venda.
Configuração do Claude Desktop
Para integrar este projeto com o Claude Desktop, você precisará configurar o arquivo claude_desktop_config.json da seguinte forma:
-
Localize o arquivo
claude_desktop_config.jsonem sua instalação do Claude Desktop. -
Adicione a seguinte configuração dentro do objeto
mcpServers:{ "mcpServers": { "vendas-analysis-server": { "command": "java", "args": [ "-jar", "C:\\Fontes\\FontesSTS\\spring-mcp\\target\\spring-mcp-0.0.1-SNAPSHOT.jar" ] } } }Observação: Certifique-se de que o caminho para o arquivo
.jar(C:\\Fontes\\FontesSTS\\spring-mcp\\target\\spring-mcp-0.0.1-SNAPSHOT.jar) esteja correto e aponte para o local onde o JAR do seu projeto foi compilado.