開発者ガイド: 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       │     │（リアルタイムデータ）│
│                 │<────│                  │<────│                 │
└─────────────────┘     └──────────────────┘     └─────────────────┘

仕組み：

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

前提条件

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

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

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

  1. サンプル CRM スプレッドシートを開きます
  2. File > Make a copy をクリックして、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）

ステップ 2: Code Assist MCP のインストールと設定

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

ステップ 3: Cursor で Code Assist MCP を使用する設定

  1. 接続を保存したら、設定ウィザードで Next をクリックします
  2. AI MCP Tool ドロップダウンから Cursor を選択します AI MCP Tool ドロップダウンで Cursor を選択
  3. 手順に従って MCP 設定を作成します：
    • プロジェクトディレクトリに .cursor フォルダを作成します
    • .cursor フォルダ内に mcp.json ファイルを作成します
    MCP クライアント設定手順（ファイルパスと 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 と表示

ステップ 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 と入力）。

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

  1. プロジェクト用の新しいフォルダを作成し、Cursor で開きます
  2. Cursor の AI チャットペインを開きます（チャットアイコンをクリックするか、Toggle AI Pane コマンドを使用）
  3. まず、Cursor に MCP 接続の手順を確認してもらいます：
    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 コードを生成

ステップ 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 を使ったデータパイプラインを構築する
  • 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 が誤ったカラム名を生成する - コード生成の前に、Cursor に MCP 接続の手順を再度確認してもらいましょう。これによりスキーマのコンテキストが更新されます。

CData による Python 開発

CData Code Assist MCP と CData Python Connector は同じデータモデルを共有しているため、開発中に検証した SQL がそのまま本番環境で動作します。AI が生成したコードと実際のデータアクセスの間にギャップが生じることはありません。

Code Assist MCP は、コーディングツールがサポートする任意の AI モデルで動作します。モデルに依存しない設計のため、Cursor で GPT-4、Claude、その他のモデルのいずれを使用していても、同じ正確なスキーマコンテキストが提供されます。

Python 開発を加速させる準備はできましたか？ Code Assist MCP for Google Sheets を無料でダウンロードし、 CData Python Connector for Google Sheets の無料トライアルを入手して、今すぐ始めましょう。