McpServer

Um servidor de implementação do Model Context Protocol (MCP) para integração com modelos de IA e gerenciamento de livros.

Visão Geral

O McpServer é uma solução completa para integrar modelos de IA do Ollama com uma API de gerenciamento de livros. O projeto implementa o protocolo MCP (Model Context Protocol) e oferece uma interface HTTP para execução de ferramentas via API.

O sistema é composto por três componentes principais:
- McpServer: Implementação do protocolo MCP em .NET
- Livros API: API para gerenciamento de dados de livros
- Ollama: Serviço para execução de modelos de IA

Requisitos do Sistema

- Docker e Docker Compose
- .NET 9.0 (para desenvolvimento)
- Pelo menos 8GB de RAM (recomendado 16GB para modelos de IA maiores)
- 10GB de espaço em disco

Instalação e Execução

Método 1: Usando Docker Compose (Recomendado)

1. Clone o repositório:

   git clone https://github.com/Adriano-Severino/McpServer.git

   cd McpServer

   

2. Execute o sistema usando Docker Compose:

   docker-compose up -d

   

3. Verifique se todos os serviços estão rodando:

   docker-compose ps

   

Método 2: Executando localmente (para desenvolvimento)

1. Clone o repositório:

   git clone https://github.com/Adriano-Severino/McpServer.git

   cd McpServer

   

2. Execute o Ollama localmente ou via Docker:

   docker run -d -p 11434:11434 -v ollama_data:/root/.ollama --name ollama ollama/ollama

   

3. Execute a API de Livros:

   cd Livros

   dotnet run

   

4. Configure as variáveis de ambiente para o McpServer:

   set OLLAMA_BASE_URL=http://localhost:11434

   set API_BASE_ADDRESS=http://localhost:5000/api/

   

5. Execute o McpServer:

   cd McpServer

   dotnet run

   

Uso do Sistema

Uma vez que o sistema esteja em execução, você pode acessar:

Endpoints da API

- Servidor MCP: http://localhost:5500
- Lista de ferramentas: http://localhost:5500/api/tools
- Documento OpenAPI: http://localhost:5500/api/openapi.json
- Execução de ferramentas: http://localhost:5500/api/execute (POST)

- API de Livros: http://localhost:5000
- API REST para gerenciamento de livros

Integração com Open WebUI

Para integrar com o Open WebUI:

1. Inicie o Open WebUI (se não estiver usando o docker-compose completo):

   docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=http://localhost:11434 -e MCP_SERVER_URL=http://localhost:5500 ghcr.io/open-webui/open-webui:cuda

   

2. Acesse o Open WebUI em: http://localhost:3000

3. Configure a conexão com o MCP Server:
- URL: http://localhost:5500/api/openapi.json

Ferramentas Disponíveis

O MCP Server oferece as seguintes ferramentas:

Gerenciamento de Livros

- ObterAsync: Buscar livros com filtro opcional por título
- ObterPorAutor: Buscar livros com filtro por autor
- CadastrarAsync: Criar/cadastrar um novo livro
- AtualizarAsync: Atualizar dados de um livro existente

Integração com Ollama

- ListModels: Lista os modelos disponíveis no Ollama
- GenerateResponse: Gera uma resposta usando um modelo do Ollama

Utilidades do Sistema

- VerificarConectividade: Verifica a conectividade entre os componentes
- ExibirConfiguracao: Exibe as configurações de conexão do MCP Server

Exemplos de Uso

Exemplo 1: Listar Livros

// POST para http://localhost:5500/api/execute
{
  "tool": "ObterAsync",
  "parameters": {
    "titulo": "O Senhor dos Anéis"
  }
}

Exemplo 2: Cadastrar um Livro

// POST para http://localhost:5500/api/execute
{
  "tool": "CadastrarAsync",
  "parameters": {
    "livro": {
      "titulo": "O Hobbit",
      "autor": "J.R.R. Tolkien",
      "anoPublicacao": 1937,
      "genero": "Fantasia"
    }
  }
}

Exemplo 3: Gerar Resposta com Ollama

// POST para http://localhost:5500/api/execute
{
  "tool": "GenerateResponse",
  "parameters": {
    "model": "llama3",
    "prompt": "Escreva um resumo sobre O Senhor dos Anéis"
  }
}

Configuração

Variáveis de Ambiente

- OLLAMA_BASE_URL: URL base para o serviço Ollama (padrão: http://ollama:11434)
- API_BASE_ADDRESS: Endereço base da API de Livros (padrão: http://livros-api:5000/api/)

Solução de Problemas

Problemas de Conectividade

Se encontrar problemas de conectividade entre os serviços:

1. Verifique se todos os contêineres estão em execução:

   docker-compose ps

   

2. Use a ferramenta de verificação de conectividade:

   // POST para http://localhost:5500/api/execute

   {

     "tool": "VerificarConectividade",

     "parameters": {}

   }

   

3. Verifique os logs dos contêineres:

   docker-compose logs mcpserver

   docker-compose logs livros-api

   docker-compose logs ollama

   

Problemas com Modelos Ollama

Se os modelos não estiverem carregando:

1. Verifique se o Ollama está em execução
2. Verifique se o modelo está disponível no Ollama:

   docker exec -it ollama ollama list

   

   docker exec -it ollama ollama pull llama3

   

Arquitetura do Sistema

┌─────────────┐     ┌──────────────┐     ┌───────────┐
│  Open WebUI │────►│  MCP Server  │────►│  Ollama   │
└─────────────┘     └──────────────┘     └───────────┘
                           │
                           ▼
                    ┌──────────────┐
                    │  Livros API  │
                    └──────────────┘

Desenvolvimento

Para contribuir com o projeto:

1. Faça um fork do repositório
2. Crie uma branch para sua feature (git checkout -b feature/nome-da-feature)
3. Faça commit das alterações (git commit -am 'Adiciona funcionalidade X')
4. Faça push para a branch (git push origin feature/nome-da-feature)
5. Crie um Pull Request