開発者ガイド:Code Assist MCP と Python

AI アシスト開発で Python アプリケーションをよりスピーディーに構築しましょう。このガイドでは、 CData Code Assist MCPCursor などの 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       │     │(リアルタイムデータ)│
│                 │<────│                  │<────│                 │
└─────────────────┘     └──────────────────┘     └─────────────────┘

仕組み:

  1. Code Assist MCP がデータソースに接続し、スキーマ情報を Cursor に公開します
  2. Cursor の AI がこのコンテキストを活用して、正確なテーブル名とカラム名を含む Python コードを生成します
  3. 本番アプリケーションは CData Python Connector を使用します。スキーマも SQL 構文も同一です

前提条件

開始する前に、以下がインストールされていることを確認してください。


Step 1:Google Sheets にサンプルデータを準備する

ワークフローのデモとして、サンプル CRM データを含む Google Sheet を使用します。

  1. サンプル CRM スプレッドシートにアクセスします
  2. ファイル > コピーを作成 をクリックして Google ドライブに保存します
  3. わかりやすい名前を付けます(例:「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 をインストール・設定する

  1. CData Code Assist MCP for Google Sheets をダウンロードしてインストールします
  2. インストール後に Code Assist MCP の設定ウィザードを起動します
  3. 新しい設定を作成し、名前を付けます(例:「cdata-googlesheets」)
  4. Google Sheets への接続を設定します。
    • Connect をクリックして OAuth で Google 認証を行います
    • 認証後、Spreadsheet フィールドにスプレッドシート名を入力します(例:「demo_organization」)
    Google Sheets MCP 接続設定画面(OAuth と Spreadsheet フィールド)
  5. Save & Test をクリックして接続を検証します 接続成功メッセージと Next ボタンが表示された画面

Step 3:Cursor で Code Assist MCP を使用する設定を行う

  1. 接続を保存したら、設定ウィザードで Next をクリックします
  2. AI MCP Tool ドロップダウンから Cursor を選択します AI MCP Tool ドロップダウンで Cursor を選択した画面
  3. 表示される手順に従って MCP 設定を作成します。
    • プロジェクトディレクトリに .cursor フォルダを作成します
    • .cursor フォルダ内に mcp.json ファイルを作成します
    MCP Client Instructions 画面(ファイルパスと Copy JSON ボタン)
  4. Copy JSON をクリックし、コピーした設定内容を mcp.json ファイルに貼り付けます
  5. Cursor を再起動して新しい MCP 設定を読み込みます

MCP 接続の確認

  1. Cursor で Ctrl+Shift+P(macOS の場合は Cmd+Shift+P)を押してコマンドパレットを開きます
  2. View: Open MCP Settings と入力して選択します
  3. 設定画面で Tools & MCP に移動します Cursor の設定画面(サイドバーに Tools & MCP が表示されている)
  4. Installed MCP Servers の下に、Code Assist MCP 接続(例:「cdata-googlesheets」)が Running と表示されていることを確認します Cursor MCP 設定で cdata-googlesheets 接続が Running として表示されている画面

Step 4:CData Python Connector をインストールする

Python Connector は、生成されたアプリケーションの実行時に使用されます。

  1. CData Python Connector for Google Sheets をダウンロードし、ZIP ファイルを展開します
  2. ターミナルを開き、インストーラーファイルが含まれるディレクトリに移動します。例: cd C:\Users\Public\Downloads\GoogleSheetsPythonConnector\CData.Python.GoogleSheets\win\Python312\64
  3. 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
  4. インストールを確認します。 pip list | grep cdata

    cdata-googlesheets-connector が一覧に表示されれば、インストールは成功です。

  5. パッケージに含まれるライセンスインストーラーを実行してライセンスをインストールします。
    • Windows: ライセンスインストーラーのディレクトリ(例:Lib\site-packages\cdata\installlic_googlesheets)に移動し、以下を実行します。 .\license-installer.exe
    • macOS/Linux: ライセンスインストーラーのディレクトリに移動し、以下を実行します。 ./license-installer

    プロンプトが表示されたらライセンスキーを入力します(30 日間の評価版を利用する場合は TRIAL と入力)。

Step 5:Cursor でアプリケーションを構築する

  1. プロジェクト用の新しいフォルダを作成し、Cursor で開きます
  2. Cursor の AI チャットペインを開きます(チャットアイコンをクリックするか、Toggle AI Pane コマンドを使用)
  3. まず、MCP 接続の手順を確認するよう Cursor に指示します。
    Review the instructions for my cdata-googlesheets connection
    Cursor AI チャットで MCP 接続手順を確認している画面
  4. 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.
  5. Cursor が以下を生成します。
    • 適切な DB-API パターン(connect、cursor、execute、fetchall)を使用した Python コード
    • 実際の Google Sheets スキーマに基づいた正確なテーブル名とカラム名
    • 接続文字列の環境変数による管理
    Cursor が CData Python Connector を使用する Python コードを生成している画面

Step 6:アプリケーションの設定と実行

  1. 接続文字列を環境変数に設定します。 set GOOGLESHEETS_CONN="Spreadsheet=demo_organization;InitiateOAuth=GETANDREFRESH;"

    macOS/Linux の場合は、set の代わりに export を使用してください。

  2. Python スクリプトを実行します。 python googlesheets_app.py
  3. アプリケーションが 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 を使ってデータパイプラインを構築する
  • SalesforceJira など、別のデータソースに接続する

トラブルシューティング

問題が発生した場合は、以下の解決方法をお試しください。

  • 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 の無料トライアルを入手して、今すぐ始めましょう。