io.github.CloudCorpRecords/localmodels

Registre officiel Autres

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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @reneturcios/localmodels
Claude Code
claude mcp add localmodels -- npx -y @reneturcios/localmodels@0.1.0 mcp
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "localmodels": {
            "command": "npx",
            "args": [
                "-y",
                "@reneturcios/localmodels@0.1.0",
                "mcp"
            ]
        }
    }
}
OCI package ghcr.io/cloudcorprecords/localmodels:0.1.0
Claude Code
claude mcp add localmodels -- docker run -i --rm ghcr.io/cloudcorprecords/localmodels:0.1.0 mcp
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "localmodels": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/localmodels:0.1.0",
                "mcp"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. localmodels
  2. Install
  3. CLI
  4. MCP server
  5. Development
  6. License

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.

Questions fréquentes

Qu'est-ce que io.github.CloudCorpRecords/localmodels ?

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

Comment installer io.github.CloudCorpRecords/localmodels ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add localmodels -- npx -y @reneturcios/localmodels@0.1.0 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.CloudCorpRecords/localmodels ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.CloudCorpRecords/localmodels est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.CloudCorpRecords/localmodels ?

Il est publié par CloudCorpRecords. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.