Ollama × Antigravity MCP 設定手順

トークン節約のため、OllamaをAntigravityのサブエージェントとして使用する手順。

---

前提条件

• macOS（Apple Silicon）
• Antigravity インストール済み
• Node.js インストール済み

---

Step 1: Ollama インストール

brew install ollama

または https://ollama.com からインストーラーをダウンロード。

推奨モデルをダウンロード

M4 / 16GB RAM 環境での推奨：

ollama pull qwen2.5-coder:7b

起動確認

ollama serve

address already in use と表示された場合は既に起動中なのでOK。

---

Step 2: mcp_config.json を編集

ファイルの場所

~/.gemini/antigravity/mcp_config.json

Finderで開く方法

1. Finder を開く
2. Command + Shift + . で隠しフォルダを表示
3. ~/.gemini/antigravity/ に移動

または ターミナルで開く

open ~/.gemini/antigravity/mcp_config.json

ファイルがない場合：

mkdir -p ~/.gemini/antigravity
touch ~/.gemini/antigravity/mcp_config.json
open ~/.gemini/antigravity/mcp_config.json

設定内容

{
  "mcpServers": {
    "ollama": {
      "command": "npx",
      "args": ["ollama-mcp-server"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

---

Step 3: Antigravity を再起動して確認

Antigravity を再起動後、エージェントパネルで確認：

1. エージェントパネルの 「…」メニュー を開く
2. 「Manage MCP Servers」 で ollama が表示されていればOK

またはエージェントに直接確認：

What MCP tools do you have available?

ollama_* 系のツールが返ってくれば認識済み。

---

Step 5: エージェントルールを設定

プロジェクトルートでルールファイルを作成：

mkdir -p .agent/rules

.agent/rules/ollama-routing.md を作成：

---
trigger: always_on
description: Route simple tasks to Ollama to save tokens
---

# Ollama Routing Rules
以下のタスクはOllamaツール（ollama_run または ollama_chat_completion）を使用すること：
- コードのフォーマット・整形
- 単純なリネーム・変数名変更
- コメントの追加
- 簡単な型定義の生成
- ファイル内容の要約
- テストコードの雛形（ボイラープレート）作成
- データ構造の変換（JSONからDataclassなど）
- 簡単な正規表現の作成・解説
- UI文言やドキュメントの簡単な翻訳
- Gitのコミットメッセージ案の生成
- 標準ライブラリ等の基本的な使い方の調査

以下はGemini（自分）が処理すること：
- アーキテクチャ設計
- バグ修正
- 複雑なロジック実装
- コードレビュー
Ollamaで使用するモデル: qwen2.5-coder:7b

---

タスク振り分けの目安

タスク	エージェント
コードフォーマット・整形	Ollama
変数名・リネーム	Ollama
コメント追加	Ollama
型定義の生成	Ollama
ファイル要約	Ollama
テストコードの雛形作成	Ollama
データ構造の変換	Ollama
正規表現の作成・解説	Ollama
UI文言・ドキュメントの翻訳	Ollama
コミットメッセージ案の生成	Ollama
標準ライブラリの使い方調査	Ollama
バグ修正	Antigravity (Gemini)
アーキテクチャ設計	Antigravity (Gemini)
複雑なロジック実装	Antigravity (Gemini)
コードレビュー	Antigravity (Gemini)

---

トラブルシューティング

Ollama が応答しない場合

ollama serve

で起動確認。address already in use なら既に起動中なのでOK。

MCP が認識されない場合

• mcp_config.json の JSON 構文エラーがないか確認
• Antigravity を完全に再起動
• ollama list でモデルが存在するか確認

ollama list