localmodels

localmodels

localmodels は、ローカルで実行中の Ollama サーバーを MCP インターフェース（対応する CLI 付き）の背後に配置します。インストール済みモデルの一覧表示、モデルの取得や削除、モデルの詳細確認を行い、さらに生成、チャット、埋め込みを実行できます。すべて、ご自身のマシンで動作するモデルが対象です。

API キーもアカウントも不要です。サーバーアドレスは OLLAMA_HOST から取得し、デフォルトは http://127.0.0.1:11434 です。スキームのない値には先頭に http:// が付加され、末尾のスラッシュは無視されます。Ollama サーバーに接続できない場合、呼び出しは基盤となる接続エラーで失敗します。空の結果を捏造することはありません。

インストール

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

コンテナ内の 127.0.0.1 はコンテナ自体を指すため、コンテナでは（ホストネットワークを使用するなどして）OLLAMA_HOST をホストに設定してください。

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

終了コード：0 成功、1 サーバー／検索エラー、2 使用方法のエラー。

MCP サーバー

npx -y @reneturcios/localmodels mcp

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

env ブロックは省略可能です。指定しない場合はデフォルトのアドレスが使用されます。

ツール

ツール	入力	上流ルート
list_models	—	GET /api/tags
show_model	model	POST /api/show
pull_model	model	POST /api/pull (stream: false)
delete_model	model	DELETE /api/delete
copy_model	source, destination	POST /api/copy
generate_completion	model, prompt, system（省略可能）	POST /api/generate (stream: false)
chat_completion	model, messages（{role, content} の配列）	POST /api/chat (stream: false)
create_embedding	model, input	POST /api/embed
list_running_models	—	GET /api/ps
get_version	—	GET /api/version

開発

npm install
npm run build
npm test
npm run dev

テストはすべて fake-fetch フィクスチャを使用して実行されます。稼働中の Ollama サーバーは必要なく、接続も行いません。

ライセンス

MIT — LICENSE を参照してください。