MCP Ollama

Arquitetura

Usuário
  ↓
Interface web
  ↓
Backend agente
  ↓
Ollama
  ↓
Cliente MCP
  ↓
Servidor MCP
  ↓
PostgreSQL

1. O usuário envia uma pergunta pela interface.

2. O backend valida a pergunta.

3. O Ollama escolhe uma tool.

4. O cliente MCP chama o servidor MCP.

5. O servidor consulta o PostgreSQL.

6. O backend formata o resultado.

7. A interface apresenta a resposta.

Related MCP server: mcp-db-server

Como executar

Requisitos:

• Node.js 20 ou superior;

• npm;

• Docker e Docker Compose;

• Ollama;

• modelo qwen2.5:3b no Ollama.

Na raiz do projeto, crie e configure o arquivo de ambiente:

cp .env.example .env
nano .env

Instale as dependências:

npm install

Inicie o PostgreSQL:

docker compose up -d

Inicie o Ollama e baixe o modelo, caso ainda não esteja instalado localmente:

sudo systemctl start ollama
ollama pull qwen2.5:3b

Inicie o backend agente:

npm run start:agent

O backend inicia o MCP Server automaticamente por STDIO e também disponibiliza a interface web. Acesse:

http://127.0.0.1:3100

Como encerrar

No terminal do backend, pressione:

Ctrl+C

Isso também encerra o MCP Server iniciado pelo backend.

Pare o Ollama:

sudo systemctl stop ollama

Pare o PostgreSQL sem excluir dados ou volumes:

docker compose stop