【追記:v0.7.0修正済】AttributeError: 'Tool' object has no attribute 'inputSchema' の原因と対処法|google-analytics-mcpクラッシュ問題

皆さん、こんにちは。okamoです。

2026年7月28日現在、GA4のMCPサーバーである google-analytics-mcp (パッケージ名: analytics-mcp) を起動しようとすると、モジュールのインポート時点でクラッシュする障害が発生していました。

本記事では、発生していた生のエラーメッセージと再現手順、原因、回避策、そして本日リリースされた修正版(v0.7.0)の情報をお伝えします。


発生しているエラーと再現手順

フレッシュな環境で analytics-mcp を実行すると、認証を試みる前段階(モジュールのインポート時)で以下のエラーが発生して起動に失敗します。

再現コマンド

uv tool uninstall analytics-mcp   # 既存の永続tool cacheを消去
uvx analytics-mcp                 # クラッシュ再現

実際の出力(エラーログ)

AttributeError: 'Tool' object has no attribute 'inputSchema'のエラー画面

Traceback (most recent call last):
  File "/home/ubuntu/.cache/uv/archive-v0/aGVP9mVwFd35WiDfwzr5g/bin/analytics-mcp", line 6, in <module>
    from analytics_mcp.server import run_server
  File "/home/ubuntu/.cache/uv/archive-v0/aGVP9mVwFd35WiDfwzr5g/lib/python3.10/site-packages/analytics_mcp/server.py", line 21, in <module>
    import analytics_mcp.coordinator as coordinator
  File "/home/ubuntu/.cache/uv/archive-v0/aGVP9mVwFd35WiDfwzr5g/lib/python3.10/site-packages/analytics_mcp/coordinator.py", line 125, in <module>
    if tool.inputSchema == {}:
  File "/home/ubuntu/.cache/uv/archive-v0/aGVP9mVwFd35WiDfwzr5g/lib/python3.10/site-packages/pydantic/main.py", line 1042, in __getattr__
    raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}')
AttributeError: 'Tool' object has no attribute 'inputSchema'. Did you mean: 'input_schema'?

AttributeError: 'Tool' object has no attribute 'inputSchema' というメッセージとともに、coordinator.py の125行目で停止していることが確認できます。


エラーが発生する原因

原因は、2026年7月28日 13:45 UTCにPyPIに公開された MCP(Model Context Protocol)公式Python SDKのメジャーバージョンアップ(v1 → v2.0.0) です。

1. mcp 2.0.0 による破壊的変更

MCP v2.0.0 では、プロトコル仕様「2026-07-28 spec」に対応するための大規模なリライトが行われました。その中で、フィールド名が camelCase から snake_case へ変更されたため、旧仕様の inputSchema が廃止され input_schema に変更されました。

2. PyPI未リリースによるバージョンミスマッチ

google-analytics-mcp のGitHub公式リポジトリ main ブランチ PR #200 では、依存関係を mcp>=1.24.0,<2 とバージョン上限を設ける修正が行われていましたが、PyPI上の最新パッケージ(version = 0.6.0)は修正前のままでした。

そのため、uvxuv tool install 経由でインストールすると、上限の指定されていない古い 0.6.0 が取得され、最新の mcp 2.0.0 が入ってしまうことでクラッシュしていました。

👉google-analytics-mcpのissue(#199)はこちら


対処法・回避策(旧バージョン用)

v0.6.0を利用している場合は、mcp<2 のバージョン制約を明示的に指定してインストールすることで正常に起動できます。

uvx --with "mcp<2" analytics-mcp

【追記:2026/07/30】修正版 v0.7.0 がリリースされました!

2026年7月30日(約10時間前)、本件の修正を含んだ公式パッケージ v0.7.0 が正式にリリースされました。

依存関係に mcp のバージョン上限指定(mcp<2)が追加されたため、今後はオプションを指定せず通常通り実行するだけで最新版がインストールされ、正常に起動します。

uvx analytics-mcp

修正の詳細は以下のリリースノートをご確認ください。 👉 Release 0.7.0 · googleanalytics/google-analytics-mcp


まとめ

  • 現象: analytics-mcp 実行時に AttributeError: 'Tool' object has no attribute 'inputSchema' でクラッシュしていた
  • 原因: 2026-07-28にリリースされた mcp 2.0.0 の破壊的変更の影響
  • 最新の対応: 本日リリースされた v0.7.0 にアップデートすることで完全復旧(回避策の --with "mcp<2" は不要になりました)

おまけ:okamoちゃんねるのレビュー

この記事について、3人のAI仮想読者がレビューしてくれました。

  • クロード(辛口エンジニア)
    • 「せめてリポジトリリンクと PR リンクは足しとけ。」
  • GPT(税理士)
    • 「手順書としてはまだ不親切です。」
  • Gemini(お母さん)
    • 「okamoさんはね、昨日急にツールが動かなくなって「えっ、なんで!?💦」ってパニックになって困り果てている全国の皆さんを、1分でも早く助けたくて急いでこの記事を書いたのよ!」

👉 AI 仮想読者3人による辛口レビュー全編はこちら