Quickbase MCP Server

🚀 QuickBase MCP Server

QuickBase MCP Serverは、Model Context Protocol (MCP) を利用したサーバで、QuickBaseの操作に最大限の柔軟性を提供します。このサーバを使用すると、MCPツールを通じてテーブルの作成、フィールドの追加、リレーションシップの変更など、すべてのQuickBase操作を実行できます。

✨ 主な機能

アプリケーション管理

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

テーブル操作

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

フィールド管理

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

レコード操作

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

リレーションシップ管理

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

ユーティリティ関数

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

📦 インストール

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

cd quickbase-mcp-server
npm install

2. 環境設定のコピー:

cp env.example .env

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

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

# Optional: Default settings
QB_DEFAULT_TIMEOUT=30000
QB_MAX_RETRIES=3

# MCP Server Configuration
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"
      }
    }
  }
}

基本的な使用法

新しいテーブルの作成:

{
  "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 License