English Français العربية

io.github.CloudCorpRecords/localmodels

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @reneturcios/localmodels
Claude Code 
claude mcp add localmodels -- npx -y @reneturcios/localmodels@0.1.0 mcp
إعداد 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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "localmodels": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/localmodels:0.1.0",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو io.github.CloudCorpRecords/localmodels؟

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

كيف أثبّت io.github.CloudCorpRecords/localmodels؟

يعمل على جهازك. في Claude Code: claude mcp add localmodels -- npx -y @reneturcios/localmodels@0.1.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.CloudCorpRecords/localmodels إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.CloudCorpRecords/localmodels مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.CloudCorpRecords/localmodels؟

ينشره CloudCorpRecords. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.