O que é Ollama MCP Server?
Ollama MCP Server, do usuário do GitHub rawveg (Tim Green), envolve a biblioteca oficial de JavaScript do Ollama para que um cliente MCP como Claude Desktop ou Cline controle uma instalação local do Ollama. Ele lista os modelos instalados e em execução, mostra detalhes de cada modelo, baixa, copia, cria, apaga e publica modelos, e chama generate, chat e embeddings. Com uma chave de API do Ollama Cloud, também acessa modelos hospedados na nuvem e duas ferramentas web, busca e fetch.
Tem cerca de 178 estrelas no GitHub e uns 920 downloads semanais no npm, é escrito em TypeScript e licenciado sob AGPL-3.0. A última versão no npm, a 2.1.0, saiu em 10 de novembro de 2025; o único commit desde então é uma atualização de segurança de dependências incorporada em 13 de agosto de 2026.
Como instalar Ollama MCP Server
npx -y ollama-mcpOllama MCP Server vale a pena?
É um servidor de administração, não uma camada de delegação. Suas 13 ferramentas correspondem quase uma a uma à API do Ollama (o README fala em 14, mas o pacote publicado 2.1.0 traz 13), de modo que um agente pode fazer tudo o que você faria com o comando ollama: ver o que está instalado e carregado, baixar um modelo novo, montar um a partir de um Modelfile, copiá-lo, apagá-lo ou enviá-lo ao registro do ollama.com. Generate, chat com chamada de ferramentas e embed cobrem a inferência.
O quadro de segurança decorre do próprio Ollama. O servidor fala apenas stdio e não abre porta própria, mas conversa com a API HTTP do Ollama, que por padrão escuta em 127.0.0.1, porta 11434, e que, segundo a documentação do Ollama, não exige autenticação localmente. Qualquer coisa que alcance essa porta pode fazer o que este servidor faz. OLLAMA_HOST aceita qualquer endereço, inclusive outra máquina ou https://ollama.com, sem verificar se é loopback. ollama_delete remove um modelo do disco sem etapa de confirmação no servidor, e com OLLAMA_API_KEY definida, ollama_push pode enviar um modelo para a sua conta. Se essas chamadas precisam de aprovação fica inteiramente a cargo do seu cliente MCP.
As ferramentas do Ollama Cloud trazem alcance e risco na mesma medida. ollama_web_search e ollama_web_fetch enviam consultas a https://ollama.com/api e devolvem texto de páginas ao agente, um caminho para injeção de prompt como em qualquer ferramenta de fetch; elas tentam de novo até 3 vezes diante de limites de taxa e erros 5xx, com tempo limite de 30 segundos por requisição.
A manutenção é o ponto fraco. Não há versão nova no npm há um ano, e pull requests que corrigem o carregamento das ferramentas no Windows e repassam o cancelamento ao Ollama (#23, #24 e #28) continuam sem merge. Diante do mcp-ollama da ~alter, um servidor de Ollama bem mais novo, a troca é clara: este administra toda a instalação e alcança a nuvem, enquanto o mcp-ollama expõe dez ferramentas estreitas por tarefa, recusa hosts não locais e não consegue apagar nada.
Onde ele se destaca
Um desenvolvedor testando modelos locais para um projeto pessoal
Comparar três modelos pequenos com o mesmo prompt sem sair do chat
Peça ao agente que baixe cada modelo, rode o prompt pelo ollama_generate e informe a saída e o tempo, depois apague os perdedores. Grátis em hardware local; aprove cada exclusão no cliente.
Um engenheiro montando um pequeno protótipo de RAG em um notebook
Gerar embeddings de uma pasta de notas com um modelo local
O agente baixa o nomic-embed-text e envia lotes pelo ollama_embed, então nada sai da máquina e nenhuma API de embeddings é cobrada. Gravar os vetores em um banco é tarefa de outra ferramenta.
Um consultor autônomo com conta no Ollama Cloud
Fazer um modelo local responder perguntas que exigem uma página web atual
Rode em modo híbrido com OLLAMA_HOST em 127.0.0.1 e OLLAMA_API_KEY definida; o agente busca e obtém páginas pelo Ollama Cloud e resume localmente. O uso da web conta na conta do Ollama.
Antes de decidir
- Configuração
- Adicione npx -y ollama-mcp à configuração do Claude Desktop ou do Cline, ou rode npm install -g ollama-mcp. Precisa de Node.js e de um Ollama em execução; poucos minutos até a primeira chamada de ferramenta. Documentado para Claude Desktop e Cline.
- Integrações
- 13 ferramentas: ollama_list, ollama_show, ollama_pull, ollama_push, ollama_copy, ollama_delete, ollama_create, ollama_ps, ollama_generate, ollama_chat, ollama_embed, ollama_web_search e ollama_web_fetch. Cinco delas (pull, push, copy, create e delete) mudam o estado no disco ou no registro.
- Dados e privacidade
- Somente stdio; o servidor não abre porta. Ele chama o que OLLAMA_HOST indicar (padrão http://127.0.0.1:11434), e a API local do Ollama não tem autenticação. Com OLLAMA_API_KEY definida, a chave vai como token bearer e a busca e o fetch web vão para ollama.com. Páginas obtidas são texto não confiável. Nenhum alerta de segurança publicado.
- Custo em escala
- Grátis localmente; o custo é o seu hardware. Modelos na nuvem e ferramentas web consomem um plano do Ollama Cloud; o servidor não acrescenta nada.
- Limites
- A contagem de ferramentas do README (14) não bate com a do pacote (13). As correções de carregamento de ferramentas no Windows e de cancelamento de requisições estão em pull requests sem merge. Não há confirmação nem lista de permissões para ferramentas destrutivas.
O que é bom
- Cobre quase toda a API do Ollama, inclusive create, copy e push
- Modelos locais e do Ollama Cloud em um só servidor
- Instalação via npx sem etapa de build
- Novas tentativas com suporte a Retry-After nas ferramentas web
O que não é
- O agente pode apagar ou publicar modelos sem confirmação no servidor
- Sem verificação de loopback em OLLAMA_HOST
- Última versão no npm em novembro de 2025; correções esperam em pull requests abertos
- AGPL-3.0 é incômoda para as políticas de algumas empresas
Ideal para
Desenvolvedores que rodam o Ollama no próprio notebook e querem que um agente gerencie e chame os modelos, com as aprovações de ferramentas ativadas no cliente.
Alternativas ao Ollama MCP Server
Ollama MCP Server: perguntas frequentes
- Ollama MCP Server vale a pena?
- Um controle remoto completo do Ollama, com o qual um agente apaga ou publica seus modelos tão facilmente quanto conversa com eles, por isso combina mais com a máquina pessoal de um desenvolvedor do que com qualquer ambiente compartilhado. Damos nota 3.6 de 5.
- Quanto custa Ollama MCP Server?
- Gratuito e de código aberto (AGPL-3.0). O Ollama local é gratuito; modelos na nuvem e as ferramentas web exigem conta e chave de API do Ollama, cobradas pelos planos do próprio Ollama.
- Quais são as desvantagens de Ollama MCP Server?
- O agente pode apagar ou publicar modelos sem confirmação no servidor; sem verificação de loopback em OLLAMA_HOST; última versão no npm em novembro de 2025; correções esperam em pull requests abertos; aGPL-3.0 é incômoda para as políticas de algumas empresas.
- Para quem Ollama MCP Server é indicado?
- Desenvolvedores que rodam o Ollama no próprio notebook e querem que um agente gerencie e chame os modelos, com as aprovações de ferramentas ativadas no cliente.
- Quanto custa Ollama MCP Server para uma equipe ou em produção?
- Grátis localmente; o custo é o seu hardware. Modelos na nuvem e ferramentas web consomem um plano do Ollama Cloud; o servidor não acrescenta nada.
- Ollama MCP Server é seguro para dados da empresa?
- Somente stdio; o servidor não abre porta. Ele chama o que OLLAMA_HOST indicar (padrão http://127.0.0.1:11434), e a API local do Ollama não tem autenticação. Com OLLAMA_API_KEY definida, a chave vai como token bearer e a busca e o fetch web vão para ollama.com. Páginas obtidas são texto não confiável. Nenhum alerta de segurança publicado.
- Quais são as melhores alternativas ao Ollama MCP Server?
- As alternativas mais próximas que analisamos são mcp-ollama (~alter).
Respostas verificadas em 11 de nov. de 2026.