Back to Browse

Localmodels MCP Server

Developer ToolsModerate5.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

Talk to a local Ollama server: list, pull, inspect, generate, chat and embed.

About

Talk to a local Ollama server: list, pull, inspect, generate, chat and embed.

Security Report

5.8
Moderate5.8Moderate Risk

localmodels is a keyless MCP and CLI wrapper that forwards requests only to a local Ollama HTTP API, with no hardcoded credentials, shell execution, or data exfiltration found. The main considerations are that OLLAMA_HOST can redirect prompts and chat content to any host, and that destructive tools such as delete_model and pull_model run without confirmation, both of which users should understand. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

8 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-cloudcorprecords-localmodels": {
      "args": [
        "-y",
        "@reneturcios/localmodels"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

localmodels

localmodels puts a locally running Ollama server behind an MCP interface (with a matching CLI). List what is installed, pull or remove models, inspect one, then generate, chat, or embed — all against models that run on your own machine.

There is no API key and no account. The server address comes from OLLAMA_HOST and defaults to http://127.0.0.1:11434. A value without a scheme gets http:// in front of it, and trailing slashes are ignored. If no Ollama server is reachable, calls fail with the underlying connection error — they never invent an empty result.

Install

npx @reneturcios/localmodels list
docker run -i ghcr.io/cloudcorprecords/localmodels

In a container, point OLLAMA_HOST at the host (for example with host networking), since 127.0.0.1 inside the container is the container itself.

CLI

localmodels list
localmodels show llama3.2
localmodels pull qwen2.5
localmodels delete old:model
localmodels copy llama3.2 my-llama
localmodels generate llama3.2 "Write a haiku about autumn"
localmodels chat llama3.2 "Hello!"
localmodels embed nomic-embed-text "some text to embed"
localmodels running
localmodels version
localmodels --version

Exit codes: 0 success, 1 server/lookup error, 2 usage error.

MCP server

npx -y @reneturcios/localmodels mcp
{
  "mcpServers": {
    "localmodels": {
      "command": "npx",
      "args": ["-y", "@reneturcios/localmodels", "mcp"],
      "env": { "OLLAMA_HOST": "http://127.0.0.1:11434" }
    }
  }
}

The env block is optional; the default address is used without it.

Tools

ToolInputUpstream route
list_models—GET /api/tags
show_modelmodelPOST /api/show
pull_modelmodelPOST /api/pull (stream: false)
delete_modelmodelDELETE /api/delete
copy_modelsource, destinationPOST /api/copy
generate_completionmodel, prompt, system (optional)POST /api/generate (stream: false)
chat_completionmodel, messages (array of {role, content})POST /api/chat (stream: false)
create_embeddingmodel, inputPOST /api/embed
list_running_models—GET /api/ps
get_version—GET /api/version

Development

npm install
npm run build
npm test
npm run dev

Tests run entirely on fake-fetch fixtures; no live Ollama server is required or contacted.

License

MIT — see LICENSE.

Reviews

No reviews yet

Be the first to review this server!