開発者ガイド:Code Assist MCP と Python
AI アシスト開発で Python アプリケーションをよりスピーディーに構築しましょう。このガイドでは、 CData Code Assist MCP と Cursor などの AI コーディングツールを使い、 CData Python Connector でリアルタイムデータに接続する本番レベルの Python コードを生成する方法をご紹介します。
Code Assist MCP は、AI コーディングアシスタントにスキーマ情報を提供します。これにより、AI が実際のデータソースからテーブル、カラム、 データ型を検出できるようになります。生成された Python コードは CData Python Connector を使ってそのまま本番環境で実行可能です。フィールド名の推測やハルシネーションの心配はありません。
このガイドを完了すると、以下の機能を持つ Python スクリプトが完成します。
- CData Python Connector を使用して Google Sheets に接続
- 標準的な DB-API パターンで顧客データをクエリ
- 結果をフォーマットされたテーブルで表示
アーキテクチャの概要
Code Assist MCP は、AI アシスト開発と本番環境対応のデータアクセスを橋渡しします。
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ │ │ │ │ │
│ Cursor IDE │────>│ Code Assist MCP │────>│ Google Sheets │
│ (開発環境) │ │ (スキーマ) │ │(リアルタイムデータ)│
│ │<────│ │<────│ │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
│ 生成された Python コード
v
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ │ │ │ │ │
│ Python アプリ │────>│ CData Python │────>│ Google Sheets │
│ (本番環境) │ │ Connector │ │(リアルタイムデータ)│
│ │<────│ │<────│ │
└─────────────────┘ └──────────────────┘ └─────────────────┘
仕組み:
- Code Assist MCP がデータソースに接続し、スキーマ情報を Cursor に公開します
- Cursor の AI がこのコンテキストを活用して、正確なテーブル名とカラム名を含む Python コードを生成します
- 本番アプリケーションは CData Python Connector を使用します。スキーマも SQL 構文も同一です
前提条件
開始する前に、以下がインストールされていることを確認してください。
- Python 3.8 以降 - Python.org からダウンロード
- Cursor IDE - Cursor をダウンロード(MCP をサポートする他の AI コーディングツールでも可)
- CData Code Assist MCP for Google Sheets - ダウンロード
- CData Python Connector for Google Sheets - ダウンロード
- Google アカウント(Google Sheets へのアクセス用)
Step 1:Google Sheets にサンプルデータを準備する
ワークフローのデモとして、サンプル CRM データを含む Google Sheet を使用します。
- サンプル CRM スプレッドシートにアクセスします
- ファイル > コピーを作成 をクリックして Google ドライブに保存します
- わかりやすい名前を付けます(例:「demo_organization」)。この名前は後の手順で必要になります
このスプレッドシートには 4 つのシートが含まれています。
- account - 企業情報(Name、Industry、AnnualRevenue、NumberOfEmployees)
- opportunity - 営業パイプラインデータ(StageName、Amount、Probability、CloseDate)
- tickets - サポートケース(Subject、Priority、Status、CreatedAt)
- usage - 製品利用統計(PRODUCT_GROUP、S_STANDARDJOBRUNS、S_RECORDSAFFECTED)
Step 2:Code Assist MCP をインストール・設定する
- CData Code Assist MCP for Google Sheets をダウンロードしてインストールします
- インストール後に Code Assist MCP の設定ウィザードを起動します
- 新しい設定を作成し、名前を付けます(例:「cdata-googlesheets」)
- Google Sheets への接続を設定します。
- Connect をクリックして OAuth で Google 認証を行います
- 認証後、Spreadsheet フィールドにスプレッドシート名を入力します(例:「demo_organization」)
- Save & Test をクリックして接続を検証します
Step 3:Cursor で Code Assist MCP を使用する設定を行う
- 接続を保存したら、設定ウィザードで Next をクリックします
- AI MCP Tool ドロップダウンから Cursor を選択します
- 表示される手順に従って MCP 設定を作成します。
- プロジェクトディレクトリに .cursor フォルダを作成します
- .cursor フォルダ内に mcp.json ファイルを作成します
- Copy JSON をクリックし、コピーした設定内容を mcp.json ファイルに貼り付けます
- Cursor を再起動して新しい MCP 設定を読み込みます
MCP 接続の確認
- Cursor で Ctrl+Shift+P(macOS の場合は Cmd+Shift+P)を押してコマンドパレットを開きます
- View: Open MCP Settings と入力して選択します
- 設定画面で Tools & MCP に移動します
- Installed MCP Servers の下に、Code Assist MCP 接続(例:「cdata-googlesheets」)が Running と表示されていることを確認します
Step 4:CData Python Connector をインストールする
Python Connector は、生成されたアプリケーションの実行時に使用されます。
- CData Python Connector for Google Sheets をダウンロードし、ZIP ファイルを展開します
- ターミナルを開き、インストーラーファイルが含まれるディレクトリに移動します。例:
cd C:\Users\Public\Downloads\GoogleSheetsPythonConnector\CData.Python.GoogleSheets\win\Python312\64 - pip を使ってコネクタをインストールします。
- Windows: お使いの Python バージョンに対応する .whl ファイルをインストールします。
pip install cdata_googlesheets_connector-24.0.9111-cp312-cp312-win_amd64.whl - macOS/Linux: .tar.gz ファイルをインストールします。
pip install cdata_googlesheets_connector-24.0.####-python3.tar.gz
- Windows: お使いの Python バージョンに対応する .whl ファイルをインストールします。
- インストールを確認します。
pip list | grep cdatacdata-googlesheets-connector が一覧に表示されれば、インストールは成功です。
- パッケージに含まれるライセンスインストーラーを実行してライセンスをインストールします。
- Windows: ライセンスインストーラーのディレクトリ(例:Lib\site-packages\cdata\installlic_googlesheets)に移動し、以下を実行します。
.\license-installer.exe - macOS/Linux: ライセンスインストーラーのディレクトリに移動し、以下を実行します。
./license-installer
プロンプトが表示されたらライセンスキーを入力します(30 日間の評価版を利用する場合は TRIAL と入力)。
- Windows: ライセンスインストーラーのディレクトリ(例:Lib\site-packages\cdata\installlic_googlesheets)に移動し、以下を実行します。
Step 5:Cursor でアプリケーションを構築する
- プロジェクト用の新しいフォルダを作成し、Cursor で開きます
- Cursor の AI チャットペインを開きます(チャットアイコンをクリックするか、Toggle AI Pane コマンドを使用)
- まず、MCP 接続の手順を確認するよう Cursor に指示します。
Review the instructions for my cdata-googlesheets connection
- Cursor がコンテキストを取得したことを確認したら、アプリケーションの構築を指示します。
Build a Python script that connects to Google Sheets using the CData Python Connector. Query the "account" sheet and display all accounts with their Name, Industry, and AnnualRevenue in a formatted table. Use the schema from my cdata-googlesheets MCP connection. Store the connection string in an environment variable for security.
- Cursor が以下を生成します。
- 適切な DB-API パターン(connect、cursor、execute、fetchall)を使用した Python コード
- 実際の Google Sheets スキーマに基づいた正確なテーブル名とカラム名
- 接続文字列の環境変数による管理
Step 6:アプリケーションの設定と実行
- 接続文字列を環境変数に設定します。
set GOOGLESHEETS_CONN="Spreadsheet=demo_organization;InitiateOAuth=GETANDREFRESH;"macOS/Linux の場合は、set の代わりに export を使用してください。
- Python スクリプトを実行します。
python googlesheets_app.py - アプリケーションが Google との認証を行い(必要な場合)、アカウントデータが表示されます
出力例
Name Industry AnnualRevenue ------------------------------------------------------------ Acme Corporation Technology 2500000 Global Industries Manufacturing 15000000 StartupCo Software 500000 Enterprise Inc Finance 50000000
次のステップ
AI アシスト開発を使って、Python アプリケーションを構築できました。同じパターンは、CData Python Connector が対応する数百種類のデータソースすべてで利用できます。
次のステップとして、以下をお試しください。
- CRUD 操作(作成、更新、削除)をスクリプトに追加する
- 複数のシートをクエリしてデータを結合する
- Pandas や SQLAlchemy を使ってデータパイプラインを構築する
- Salesforce や Jira など、別のデータソースに接続する
トラブルシューティング
問題が発生した場合は、以下の解決方法をお試しください。
- Cursor で MCP が「Running」と表示されない - mcp.json ファイルが正しい場所(プロジェクトルートの .cursor フォルダ内)にあるか確認してください。設定を追加・変更した後は Cursor を再起動してください。
- OAuth 認証が失敗する - ブラウザでポップアップが有効になっているか確認してください。ブラウザのキャッシュをクリアするか、プライベート/シークレットウィンドウで OAuth フローを試してみてください。
- cdata コネクタの ModuleNotFoundError が発生する - CData Python Connector が現在アクティブな Python 環境にインストールされているか確認してください。pip list | grep cdata を実行して確認できます。お使いの Python バージョンとプラットフォームに対応する正しい .whl または .tar.gz ファイルをインストールしたか確認してください。
- 接続文字列のエラー - 接続文字列内のスプレッドシート名が正確に一致しているか(大文字・小文字を区別)、また Google ドライブでそのスプレッドシートにアクセスできるか確認してください。
- AI が不正確なカラム名を生成する - コードを生成する前に、MCP 接続の手順を再度確認するよう Cursor に指示してください。これによりスキーマのコンテキストが更新されます。
CData で Python 開発を加速する
CData Code Assist MCP と CData Python Connector は同じデータモデルを共有しているため、開発中に検証した SQL がそのまま本番環境でも同様に動作します。AI が生成したコードと実際のデータアクセスとの間のギャップを解消します。
Code Assist MCP は、コーディングツールがサポートするあらゆる AI モデルに対応しています。Cursor で GPT-4、Claude、その他のモデルのいずれを使用していても、MCP は同じ正確なスキーマコンテキストを提供します。
Python 開発を加速する準備はできましたか? Code Assist MCP for Google Sheets を無料でダウンロードし、 CData Python Connector for Google Sheets の無料トライアルを入手して、今すぐ始めましょう。