O que é mcp-ollama (~alter)?
mcp-ollama, publicado como @truealter/mcp-ollama pela Alter Meridian, a empresa australiana por trás do serviço de identidade ~alter, permite que um agente na nuvem como o Claude Code repasse trabalho rotineiro a um modelo rodando no Ollama na mesma máquina. Suas dez ferramentas são desenhadas em torno de tarefas, não de chamadas de API: resumir, classificar ou etiquetar, redigir segundo uma convenção, escrever docstrings e testes, revisar código, transformar um diff em mensagem de commit ou changelog, converter formatos e fazer um modelo de visão descrever uma captura de tela.
É muito novo e muito pequeno: criado em 1 de setembro de 2026, Apache-2.0, TypeScript, 1 estrela no GitHub e cerca de 75 downloads semanais no npm. A versão mais recente no npm é a 0.2.1, de 3 de setembro de 2026, e ele consta do registro oficial de MCP.
Como instalar mcp-ollama (~alter)
npx -y @truealter/mcp-ollamamcp-ollama (~alter) vale a pena?
mcp-ollama responde a uma pergunta diferente da do ollama-mcp. Ele não administra o Ollama; dá a um agente na nuvem um par de mãos mais barato. As dez ferramentas trazem seus próprios prompts, de modo que local_diff com commit-message pede modo imperativo e um assunto com menos de 72 caracteres, e local_code oferece docstring, test, explain, review, types, comments e refactor-suggest. O gerenciamento de modelos se limita a local_models e local_pull. Não há ferramenta de delete, copy, create ou push, então um agente não consegue remover nem publicar seus modelos por meio dele.
As escolhas de segurança são a melhor parte, pela nossa leitura do código. Ele fala apenas stdio e não abre porta. A API local do Ollama na porta 11434 não exige autenticação, por isso o servidor recusa na inicialização qualquer OLLAMA_HOST que não seja localhost, 127.0.0.1 ou ::1, a menos que MCP_OLLAMA_ALLOW_REMOTE=1 esteja definido, o que impede que uma configuração alterada mande prompts para outro lugar sem aviso. Os nomes de modelo são checados contra um padrão que rejeita um host de registro, porque o Ollama trata um primeiro segmento com ponto como registro alternativo e baixaria dele. local_vision lê imagens a partir de caminhos informados por quem chama, mas só PNG ou JPEG, com limite de 32 MB cada.
Os padrões são pensados para uma única GPU. O modelo de texto é hermes3:8b e o de visão qwen2.5vl:7b, com o contexto de visão limitado a 8.192 tokens e o modelo mantido carregado por 30 minutos. Os tetos de saída são fixos no código (512 tokens para uma mensagem de commit, 4.096 para código e transformações), e o README avisa que o modelo de visão inventa dados abaixo de cerca de 1.280 pixels de largura. Não há streaming, fila nem cache, nem suporte ao Ollama Cloud.
O porém está em tudo o que cerca o código. O README está em parte desatualizado: diz que local_pull rejeita nomes com tag, mas a versão publicada 0.2.1 os aceita. Boa parte do README é propaganda do produto de identidade da ~alter, e se o runtime da ~alter estiver instalado, o servidor acrescenta contagens de tokens a um arquivo na sua pasta pessoal. Nada sai da máquina, mas vale saber. Com uma única empresa mantenedora e quase nenhum usuário, o risco é o abandono, não a má engenharia.
Onde ele se destaca
Um desenvolvedor com um plano do Claude Code cobrado por uso
Escrever mensagens de commit e descrições de PR sem gastar tokens de um modelo de ponta
O agente passa git diff --staged ao local_diff com commit-message ou pr-description, e o hermes3:8b redige na GPU local. O modelo na nuvem só lê o resultado curto.
Uma engenheira de front-end conferindo estados da interface
Descobrir se uma captura mostra dados reais, um estado vazio ou um erro
local_vision envia o PNG ao qwen2.5vl:7b e devolve o que está na tela e qualquer texto cortado. Use resolução quase completa; ele não classifica gravidade nem aprova o design.
Um líder de suporte em uma empresa de software com 20 pessoas
Etiquetar por área de produto um lote de tickets exportados sem enviá-los a uma API na nuvem
O agente percorre o arquivo e chama local_analyze com uma lista fixa de etiquetas; o texto dos clientes fica na máquina e só os rótulos voltam ao contexto do agente.
Antes de decidir
- Configuração
- ollama pull hermes3:8b e depois claude mcp add --transport stdio ollama -- npx -y @truealter/mcp-ollama. Precisa de Node 18 ou mais novo. Use o nome com escopo; o mcp-ollama sem escopo no npm é de outro publicador. Docker exige build local e MCP_OLLAMA_ALLOW_REMOTE=1.
- Integrações
- 10 ferramentas: local_generate, local_summarize, local_analyze, local_draft, local_code, local_diff, local_transform, local_models, local_pull e local_vision. Só local_pull altera algo no disco.
- Dados e privacidade
- Somente stdio, sem porta e sem telemetria. Chama apenas OLLAMA_HOST, loopback por padrão. local_vision pode ler qualquer caminho PNG ou JPEG que receber, até 32 MB. Se o runtime da ~alter estiver instalado, cada geração acrescenta ferramenta, modelo e contagem de tokens a ~/.local/share/alter-runtime/token-burn.jsonl. Nenhum alerta publicado; relatos vão para security@truealter.com.
- Custo em escala
- Grátis; o custo é tempo de GPU. O README sugere qwen2.5-coder:32b para revisão de código, que pede uma placa grande, e um modelo de 14B para texto corrido em uma placa de 16 GB.
- Limites
- Sem streaming, fila ou cache. max_tokens só em local_generate (padrão 2.048) e local_summarize (1.024). Contexto de visão limitado a 8.192 tokens. Só a versão 0.x mais recente recebe correções de segurança.
O que é bom
- Recusa por padrão hosts do Ollama que não sejam loopback
- Nenhuma ferramenta que apague, copie ou publique modelos
- Ferramentas por tarefa com prompts embutidos
- Ferramenta de visão local com checagem de tipo e tamanho de arquivo
O que não é
- Uma versão, 1 estrela e cerca de 75 downloads semanais
- README fora de sintonia com o código publicado
- Tetos de saída fixos na maioria das ferramentas
- Sem Ollama Cloud, streaming ou remoção de modelos
Ideal para
Desenvolvedores que pagam por token a um agente na nuvem, já rodam o Ollama em uma GPU razoável e querem manter locais as tarefas de texto rotineiras.
Alternativas ao mcp-ollama (~alter)
mcp-ollama (~alter): perguntas frequentes
- mcp-ollama (~alter) vale a pena?
- Código cuidadoso e enxuto para repassar tarefas baratas a um modelo local, limitado sobretudo por ser um projeto de dois meses com uma única estrela. Damos nota 3.5 de 5.
- Quanto custa mcp-ollama (~alter)?
- Gratuito e de código aberto (Apache-2.0). Roda apenas contra o seu próprio Ollama, então o custo é o seu hardware.
- Quais são as desvantagens de mcp-ollama (~alter)?
- Uma versão, 1 estrela e cerca de 75 downloads semanais; rEADME fora de sintonia com o código publicado; tetos de saída fixos na maioria das ferramentas; sem Ollama Cloud, streaming ou remoção de modelos.
- Para quem mcp-ollama (~alter) é indicado?
- Desenvolvedores que pagam por token a um agente na nuvem, já rodam o Ollama em uma GPU razoável e querem manter locais as tarefas de texto rotineiras.
- Quanto custa mcp-ollama (~alter) para uma equipe ou em produção?
- Grátis; o custo é tempo de GPU. O README sugere qwen2.5-coder:32b para revisão de código, que pede uma placa grande, e um modelo de 14B para texto corrido em uma placa de 16 GB.
- mcp-ollama (~alter) é seguro para dados da empresa?
- Somente stdio, sem porta e sem telemetria. Chama apenas OLLAMA_HOST, loopback por padrão. local_vision pode ler qualquer caminho PNG ou JPEG que receber, até 32 MB. Se o runtime da ~alter estiver instalado, cada geração acrescenta ferramenta, modelo e contagem de tokens a ~/.local/share/alter-runtime/token-burn.jsonl. Nenhum alerta publicado; relatos vão para security@truealter.com.
- Quais são as melhores alternativas ao mcp-ollama (~alter)?
- As alternativas mais próximas que analisamos são Ollama MCP Server.
Respostas verificadas em 11 de nov. de 2026.