Quickbase MCP Server

🚀 QuickBase MCP Server

QuickBaseの操作に最大限の柔軟性を提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用すると、MCPツールを通じてテーブルの作成、フィールドの追加、リレーションシップの変更など、すべてのQuickBase操作を行うことができます。

✨ 主な機能

アプリケーション管理

• アプリケーション情報の取得
• すべてのテーブルの一覧表示
• 接続テスト

テーブル操作

• 新しいテーブルの作成
• テーブル情報の取得
• テーブルプロパティの更新
• テーブルの削除

フィールド管理

• テーブルのすべてのフィールドの取得
• 新しいフィールドの作成（すべてのタイプをサポート）
• 既存のフィールドの更新
• フィールドの削除
• 参照、数式、リレーションシップのサポート

レコード操作

• フィルタリングとソートを使用したレコードのクエリ
• 特定のレコードの取得
• 単一または複数のレコードの作成
• 既存のレコードの更新
• レコードの削除
• テキストによるレコードの検索
• バルク操作

リレーションシップ管理

• 親子関係の作成
• 既存のリレーションシップの取得
• 外部キー管理

ユーティリティ関数

• レポートの取得と実行
• 高度なクエリ機能
• エラー処理とリトライロジック

📦 インストール

1. サーバーのクローンとセットアップ:

cd quickbase-mcp-server
npm install

2. 環境設定のコピー:

cp env.example .env

3. .env ファイルにQuickBaseの資格情報を設定します。

# QuickBase設定
QB_REALM=yourname.quickbase.com
QB_USER_TOKEN=your_quickbase_user_token_here
QB_APP_ID=yourid

# オプション: デフォルト設定
QB_DEFAULT_TIMEOUT=30000
QB_MAX_RETRIES=3

# MCPサーバー設定
MCP_SERVER_NAME=quickbase-mcp
MCP_SERVER_VERSION=1.0.0

4. プロジェクトのビルド:

npm run build

QuickBaseユーザートークンの取得方法

1. QuickBase → マイアプリ → ユーザーアカウントに移動します。
2. 「ユーザートークンの管理」をクリックします。
3. 「新しいユーザートークン」をクリックします。
4. 「MCP Server」などの名前を付けます。
5. 適切な権限を設定します。
6. トークンを .env ファイルにコピーします。

💻 使用例

サーバーを単独で実行する:

npm start

MCPクライアント設定に追加する:

MCPクライアント設定（例：Claude Desktop）に追加します。

{
  "mcpServers": {
    "quickbase": {
      "command": "node",
      "args": ["/path/to/quickbase-mcp-server/dist/index.js"],
      "env": {
        "QB_REALM": "yourname.quickbase.com",
        "QB_USER_TOKEN": "your_token_here",
        "QB_APP_ID": "yourid"
      }
    }
  }
}

利用可能なツール

アプリケーションツール

• quickbase_get_app_info - アプリケーション情報の取得
• quickbase_get_tables - すべてのテーブルの一覧表示
• quickbase_test_connection - 接続テスト

テーブルツール

• quickbase_create_table - 新しいテーブルの作成
• quickbase_get_table_info - テーブル詳細の取得
• quickbase_delete_table - テーブルの削除

フィールドツール

• quickbase_get_table_fields - すべてのフィールドの取得
• quickbase_create_field - 新しいフィールドの作成
• quickbase_update_field - 既存のフィールドの更新
• quickbase_delete_field - フィールドの削除

レコードツール

• quickbase_query_records - フィルター/ソートを使用したクエリ
• quickbase_get_record - 特定のレコードの取得
• quickbase_create_record - 新しいレコードの作成
• quickbase_update_record - 既存のレコードの更新
• quickbase_delete_record - レコードの削除
• quickbase_bulk_create_records - 複数のレコードの作成
• quickbase_search_records - テキストによる検索

リレーションシップツール

• quickbase_create_relationship - テーブルリレーションシップの作成
• quickbase_get_relationships - 既存のリレーションシップの取得

ユーティリティツール

• quickbase_get_reports - すべてのレポートの取得
• quickbase_run_report - 特定のレポートの実行

基本的な使用法

新しいテーブルの作成:

{
  "name": "quickbase_create_table",
  "arguments": {
    "name": "New Projects",
    "description": "Project tracking table"
  }
}

テーブルにフィールドを追加する:

{
  "name": "quickbase_create_field",
  "arguments": {
    "tableId": "bu65pc8px",
    "label": "Project Status",
    "fieldType": "text_choice",
    "choices": ["Planning", "Active", "Complete", "On Hold"],
    "required": true
  }
}

フィルタリングを使用したレコードのクエリ:

{
  "name": "quickbase_query_records",
  "arguments": {
    "tableId": "bu65pc8px",
    "where": "{6.EX.'John'}",
    "top": 10,
    "sortBy": [{"fieldId": 3, "order": "DESC"}]
  }
}

新しいレコードの作成:

{
  "name": "quickbase_create_record",
  "arguments": {
    "tableId": "bu65pc8px",
    "fields": {
      "6": {"value": "John Doe"},
      "7": {"value": "123 Main St"},
      "8": {"value": "john@example.com"}
    }
  }
}

サポートされるフィールドタイプ

• text - 1行テキスト
• text_choice - 単一選択ドロップダウン
• text_multiline - 複数行テキスト
• richtext - リッチテキストエディター
• numeric - 数値フィールド
• currency - 通貨フィールド
• percent - パーセントフィールド
• date - 日付フィールド
• datetime - 日付/時間フィールド
• checkbox - チェックボックスフィールド
• email - メールアドレスフィールド
• phone - 電話番号フィールド
• url - URLフィールド
• address - 住所フィールド
• file - ファイル添付
• lookup - 別のテーブルからの参照
• formula - 計算フィールド
• reference - テーブル参照

開発

開発モードで実行する:

npm run dev

テストを実行する:

npm test

トラブルシューティング

一般的な問題

1. 認証エラー

   • ユーザートークンが正しいことを確認します。
   • トークンの権限にアプリが含まれていることを確認します。
   • レルムのホスト名が正しいことを確認します。

2. テーブル/フィールドが見つからない

   • テーブル/フィールドIDが正しいことを確認します。
   • アクセスする権限があることを確認します。

3. フィールドの作成に失敗する

   • フィールドタイプがサポートされていることを確認します。
   • 選択フィールドの選択肢が提供されていることを確認します。
   • 数式フィールドの数式構文が正しいことを確認します。

デバッグログを有効にする

環境変数を設定します。

DEBUG=quickbase-mcp:*

実装に関する注意事項

このサーバーは、以下の方法でQuickBase操作に最大限の柔軟性を提供します。

1. 直接APIアクセス - QuickBase REST API v1を直接使用します。
2. 完全なフィールドサポート - すべてのQuickBaseフィールドタイプをサポートします。
3. リレーションシップ管理 - テーブルのリレーションシップを作成および管理できます。
4. バルク操作 - 効率的なバルクレコード操作が可能です。
5. 高度なクエリ - 完全なQuickBaseクエリ構文をサポートします。
6. エラー処理 - 包括的なエラー処理とリトライロジックがあります。

📄 ライセンス

MITライセンス