glm-vision MCP Server

任意の AI Agent に「画像を見る」機能を追加します。内部では智谱の完全無料の視覚推論モデルを呼び出し、MCP プロトコル経由で標準ツールとして公開します。MCP をサポートする任意のクライアントでそのまま利用でき、API 費用はゼロです。

💡 無料保証：すべて智谱の特典ゾーンの無料モデル（GLM-4.6V-Flash / GLM-4.1V-Thinking-Flash / GLM-4V-Flash）を使用し、有料モデルは一切含まれません。長期間使用しても費用は発生しません。

公開されるツール

analyze_image(image_input, question, thinking)

戻り値：モデルが出力したテキスト分析結果。

特徴

• ローカル画像は自動的に生の base64 として読み込まれて転送されるため、画像ホストもパブリック URL も不要

• 1枚あたり5MBの上限チェック（智谱の制限）

• 429 レートリミット発生時は自動でバックオフしながら3回リトライ（1.5秒 / 3秒 / 4.5秒）

• それでも失敗した場合は自動でフォールバック：glm-4.6v-flash → glm-4.1v-thinking-flash → glm-4v-flash（すべて無料）。フォールバック時は回答の冒頭で使用されたモデルを明示します

Related MCP server: Kimi Vision MCP Server

デプロイ3ステップ

1. 依存関係のインストール

pip install -r requirements.txt

⚠️ 重要な落とし穴：mcp は 1.x をインストールする必要があります。最新の mcp 2.0.0 では組み込みの mcp.server.fastmcp モジュールが削除され、インストールすると ImportError になります。そのため pip install "mcp<2" です。

⚠️ もう一つの落とし穴：zai や zhipuai をインストールしないでください —— PyPI 上ではこれらは無関係なプレースホルダーパッケージです（zai は Zalando のもので、zhipuai はインポート名が変わっています）。本サーバーは OpenAI 互換クライアント で智谱の API に直接接続します（base_url=https://open.bigmodel.cn/api/paas/v4）、必要なのは openai パッケージだけです。

2. API Key の設定

bigmodel.cn で携帯番号登録 → コンソールの「API Keys」から新規作成、無料です。

Key の指定方法は2つあり、環境変数の優先度が高くなります：

• 方法A（推奨）：環境変数 ZHIPU_API_KEY=あなたのキー を設定

• 方法B：zhipu_key.txt.example を zhipu_key.txt にリネームし、中に Key を記入 （スクリプトは同じディレクトリのこのファイルを自動で読み込みます）

3. クライアントへの設定

クライアントの MCP 設定ファイルに追記します（パスはご自身のものに置き換えてください）：

{
  "mcpServers": {
    "glm-vision": {
      "command": "python",
      "args": ["/绝对路径/到/glm_vision_mcp.py"],
      "env": {
        "ZHIPU_API_KEY": "你的key"
      }
    }
  }
}

各クライアントの設定ファイルの場所：

command には Python インタープリターの絶対パス（例：D:/python/python.exe）を書くことをお勧めします。クライアント起動時に PATH から python が見つからなくなるのを防げます。

設定後は必ずクライアントを再起動してください —— MCP プロセスはクライアント起動時に一度だけ spawn されるため、設定やコードを変更してもホットリロードされません。

成功したかどうかの確認

クライアントを再起動したら、Agent に画像を1枚分析させてみてください：

D:\test.png の画像に何が写っているか見てください

Agent がツールが見つからないと言う場合は、以下を確認してください：設定ファイルの JSON 構文、スクリプトの絶対パスが正しいか、クライアントを再起動したか、クライアントでこのサーバーを手動で「信頼/有効化」する必要があるか（WorkBuddy、Cursor にはこの手順があります）。

よくあるエラーと対処

ファイル一覧