Server MCP Google Sheets kamu tadinya jalan normal. Begitu kamu restart atau install ulang, tiba-tiba muncul error. Pesannya spesifik: ModuleNotFoundError, Python nggak nemu modul mcp.server.fastmcp. Kamu udah coba bersihin cache dan install ulang paksa. Hasilnya tetap sama. Ternyata penyebabnya bukan config MCPProxy kamu. Biang keroknya rilis besar SDK resmi mcp yang baru keluar beberapa hari lalu.
Kenapa Server MCP Google Sheets Tiba-Tiba Error?
SDK Python resmi bernama mcp jadi fondasi hampir semua server MCP berbasis Python. Termasuk mcp-google-sheets. SDK ini baru aja rilis versi 2.0. Ini bukan update kecil, tim developernya rombak total strukturnya. Alasannya buat ngikutin spesifikasi protokol MCP terbaru per 28 Juli 2026. Masalahnya, begitu kamu jalanin perintah uvx tanpa nentuin versi spesifik, package manager otomatis narik versi 2.x. Soalnya versi itu dianggap paling baru.
Package mcp-google-sheets masih pakai kode buat versi 1.x. Dia masih manggil mcp.server.fastmcp lewat jalur lama. Kamu install versi 2.x, Python langsung nggak nemu jalur modul itu lagi. Server langsung lempar ModuleNotFoundError begitu kamu jalanin. Ini bukan cuma masalah mcp-google-sheets doang. Server MCP Python lain yang belum update dependensinya ke versi 2 juga berpotensi kena masalah serupa kalau kamu install ulang sekarang.
Cara Cek Penyebab Error MCP Google Sheets Ini
Sebelum buru-buru ubah config MCPProxy, coba reproduksi errornya manual dulu lewat terminal. Cara ini lebih efisien. Kamu langsung liat traceback lengkapnya tanpa perlu bolak-balik restart service.
sudo -u mcpproxy env HOME=/var/lib/mcpproxy uvx mcp-google-sheets@latestKalau traceback-nya mentok di baris from mcp.server.fastmcp import FastMCP, Context dengan pesan ModuleNotFoundError, kamu kena kasus yang sama persis kayak di artikel ini. Cache yang kotor kadang bikin gejala serupa juga. Kalau ragu, bersihin dulu cache uv-nya biar kamu nggak salah diagnosis.
sudo -u mcpproxy env HOME=/var/lib/mcpproxy uv cache clean --forceKalau errornya tetap identik setelah kamu bersihin cache dan install ulang, itu bukan soal cache basi. Itu soal resolusi versi mcp yang kebaru tadi.
Kenapa Bersihin Cache Doang Nggak Cukup?
Wajar kalau insting pertama kamu pas ketemu error kayak gini adalah bersihin cache dulu. Banyak masalah software memang gara-gara cache basi yang nyangkut versi lama. Tapi kasus MCP Google Sheets ini beda. uvx selalu narik ulang informasi versi terbaru dari PyPI tiap kali kamu panggil pakai akhiran @latest. Jadi cache bukan penyebabnya.
Yang sebenarnya terjadi adalah proses resolve dependency. uv nyari versi mcp paling baru dan paling kompatibel berdasarkan constraint dari package mcp-google-sheets. Package itu nggak nentuin batas atas versi mcp. uv otomatis milih versi 2.x paling baru, padahal secara kode itu belum compatible. Jadi walau cache-nya udah sebersih apapun, hasil akhirnya tetap sama. Constraint versinya harus kamu kunci manual.
Solusi Fix Error MCP Google Sheets: Kunci Versi SDK mcp
Solusinya gampang. Kamu tinggal paksa uvx pakai versi mcp di bawah 2 lewat flag –with. Jangan asal kasih batas bawah doang kayak mcp>=1.6.0. Angka itu masih ngizinin versi 2.x lewat. Kamu harus kasih batas atas juga.
sudo -u mcpproxy env HOME=/var/lib/mcpproxy uvx --with "mcp>=1.28,<2" mcp-google-sheets@latestKalau perintah ini jalan tanpa ModuleNotFoundError lagi, itu pertanda bagus. Walau nanti muncul error lain soal kredensial Google, artinya masalah modul Python-nya udah kelar. Yang tersisa cuma urusan autentikasi biasa.
Update Config MCPProxy Permanen
Biar kamu nggak perlu ulang cara ini tiap restart, edit file /etc/mcpproxy/mcp_config.json. Cari entri Google Sheets. Ubah bagian args-nya jadi kayak gini:
"args": [
"--with",
"mcp>=1.28,<2",
"mcp-google-sheets@latest"
]Validasi dulu format JSON-nya sebelum kamu restart. Kalau ada typo, kamu bakal ketauan dari awal. Bukan pas service udah kadung mati.
python3 -m json.tool /etc/mcpproxy/mcp_config.json > /dev/null && echo "JSON VALID"
sudo systemctl restart mcpproxyTroubleshooting Tambahan kalau MCP Google Sheets Masih Gagal
Kadang setelah kamu fix versi mcp ini, muncul error baru yang beda sama sekali. Misalnya soal file credentials.json yang nggak ketemu, atau OAuth yang gagal. Itu bukan lanjutan dari masalah ModuleNotFoundError tadi. Itu isu autentikasi Google Cloud yang terpisah. Jangan campur adukkan cara fixnya.
Cek dulu env GOOGLE_APPLICATION_CREDENTIALS di config server. Pastikan dia nunjuk ke file yang benar, dan filenya beneran ada di path itu.
ls -la /opt/mcpproxy/credentials/google.jsonKalau filenya ada tapi tetap gagal pas kamu tes manual, biasanya terminal kamu nggak bawa env var itu pas testing manual. Pas kamu jalanin lewat systemd service, service itu otomatis bawa env dari konfigurasi. Jadi selama config MCPProxy kamu udah benar dan service udah kamu restart, error soal kredensial ini biasanya ilang sendiri.
Kasus error MCP Google Sheets kayak gini kemungkinan bakal muncul lagi. Server MCP Python lain yang belum update dependensinya ke versi 2 juga rawan. Soalnya rilis besar mcp versi 2 ini masih baru banget. Kalau kamu juga lagi setup kombinasi server MCP filesystem dan markitdown buat baca dokumen Office di VPS yang sama, cek detail instalasinya di artikel MCP filesystem dan markitdown yang udah dibahas sebelumnya. Ketemu error module serupa di server MCP Python lain? Coba cara yang sama. Cek traceback-nya dulu, terus kunci versi mcp yang cocok pakai flag –with. Kebiasaan cek constraint dependency kayak gini bakal makin sering kamu pakai ke depannya. Ekosistem MCP masih aktif berkembang, dan rilis breaking change semacam ini kemungkinan besar bukan yang terakhir.
