つないだ MCP を初めて外した日 — 常時有効にするツールを選ぶ基準

[API Error: [{
  "error": {
    "code": 400,
    "message": "The GenerateContentRequest proto is invalid:\n  * tools[0].function_declarations: [FIELD_INVALID] At most 512 function declarations can be specified.",
    "status": "INVALID_ARGUMENT"
  }
}]]

#!/usr/bin/env python3
"""~/.gemini/settings.json の stdio 版 MCP サーバーへ順に接続し、公開ツール数を数えます。
 
使い方:  python3 count_mcp_tools.py
出力:    サーバー名 / ツール数 / 名前が長すぎるツールの件数 / 合計
"""
import json
import os
import subprocess
from pathlib import Path
 
SETTINGS_PATH = Path.home() / ".gemini" / "settings.json"
PROTOCOL_VERSION = "2025-06-18"  # サーバーは自分が話せる版を返してきます
 
 
def rpc(proc, payload):
    """JSON-RPC を1行書き、id の一致する応答が来るまで読みます。"""
    proc.stdin.write(json.dumps(payload) + "\n")
    proc.stdin.flush()
    if "id" not in payload:
        return None
    while True:
        line = proc.stdout.readline()
        if not line:
            raise RuntimeError("応答を返す前にサーバーが終了しました")
        try:
            msg = json.loads(line)
        except json.JSONDecodeError:
            continue  # 標準出力へログを吐くサーバーがあるため読み飛ばします
        if msg.get("id") == payload["id"]:
            return msg
 
 
def list_tools(conf):
    env = dict(os.environ)
    env.update({k: os.path.expandvars(v) for k, v in conf.get("env", {}).items()})
    proc = subprocess.Popen(
        [conf["command"]] + conf.get("args", []),
        stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.DEVNULL,
        cwd=conf.get("cwd"), env=env, text=True, bufsize=1,
    )
    try:
        rpc(proc, {"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {
            "protocolVersion": PROTOCOL_VERSION,
            "capabilities": {},
            "clientInfo": {"name": "tool-counter", "version": "0.1.0"},
        }})
        rpc(proc, {"jsonrpc": "2.0", "method": "notifications/initialized"})
        res = rpc(proc, {"jsonrpc": "2.0", "id": 2, "method": "tools/list"})
        return [t["name"] for t in res.get("result", {}).get("tools", [])]
    finally:
        proc.terminate()
        try:
            proc.wait(timeout=5)
        except subprocess.TimeoutExpired:
            proc.kill()
 
 
def main():
    servers = json.loads(SETTINGS_PATH.read_text()).get("mcpServers", {})
    total = 0
    for name, conf in sorted(servers.items()):
        if "command" not in conf:
            print(f"{name:22} url 接続のため数えません")
            continue
        try:
            tools = list_tools(conf)
        except Exception as err:
            print(f"{name:22} 取得できませんでした: {err}")
            continue
        total += len(tools)
        # 実際に渡る名前は mcp_{サーバー名}_{ツール名} で、63 文字を超えると途中が詰められます
        long_names = [t for t in tools if len(f"mcp_{name}_{t}") > 63]
        note = f"  名前が 63 文字超: {len(long_names)} 件" if long_names else ""
        print(f"{name:22} {len(tools):4} 個{note}")
    print(f"{'合計':22} {total:4} 個  (API 上限 512 個)")
 
 
if __name__ == "__main__":
    main()

{
  "mcpServers": {
    "site-ops": {
      "command": "npx",
      "args": ["-y", "@example/site-ops-mcp"],
      "includeTools": ["read_file", "write_file", "list_dir"],
      "timeout": 30000
    }
  }
}

{
  "mcp": {
    "excluded": ["experimental-server"]
  }
}

# いま何がつながっているかを確認します
gemini mcp list
 
# 普段は落としておきます
gemini mcp disable experimental-server
 
# その回のセッションだけ戻します
gemini mcp enable experimental-server --session