MCP Quickbase

🚀 Quickbase MCP コネクタプロジェクトドキュメント

Quickbase MCP コネクタは、Quickbase プラットフォームとの相互作用を可能にするツールです。Model Context Protocol (MCP) プロトコルを通じて、Claude などの AI アシスタントとの統合をサポートしています。このコネクタは、データ管理、ファイル操作、レポート実行などの一連の機能を提供します。

🚫 免責事項

このプロジェクトは公式の Quickbase 製品またはサービスではなく、公式のサポートも受けていません。Quickbase は登録商標であり、その著作権は関連会社に帰属します。

🚀 クイックスタート

Quickbase Desktop の設定

1. ターミナルを開き、以下のコマンドを実行して MCP サーバーを起動します。

   node src/quickbase/server.js
   

2. ブラウザで http://localhost:3535 にアクセスします。

Claude Code の使用

1. 環境変数を設定します。

   export QUICKBASE_TABLE_ID=your_table_id_here
   export QUICKBASE_RECORD_ID=your_record_id_here
   export QUICKBASE_FILE_FIELD_ID=your_file_field_id_here
   

2. サーバーを起動し、Quickbase に接続します。

✨ 主な機能

ユーザー機能

• データ管理：ユーザーがデータの作成、読み取り、更新、削除を行えます。
• ファイル操作：添付ファイルのアップロード、ダウンロード、管理をサポートします。
• レポート実行：Quickbase レポートを実行できます。

開発者機能

• 拡張性：開発者は簡単にカスタム機能モジュールを追加できます。
• エラー処理：詳細なエラー情報と解決策の提案を提供します。

📦 インストール

インストール要件

• オペレーティングシステム：Linux、macOS、Windows をサポートします。
• 依存関係：
  • Python 3.8 以上
  • Node.js 14 以上
• 認証情報：Quickbase ユーザートークンとアプリ ID が必要です。

インストール手順

ステップ 1: リポジトリをクローンする

git clone https://github.com/your-repository.git
cd your-repository

ステップ 2: 環境変数を設定する

プロジェクトのルートディレクトリに .env ファイルを作成します。

QUICKBASE_REALM_HOST=your-realm.quickbase.com
QUICKBASE_USER_TOKEN=your_user_token_here
QUICKBASE_APP_ID=your_app_id_here

ステップ 3: 依存関係をインストールする

Python と Node.js の依存関係をインストールします。

pip install -r requirements.txt
npm install

📚 ドキュメント

機能モジュール

データ管理ツール

• データの作成：API を介して POST リクエストを送信します。
• データの照会：GET リクエストでデータを取得します。
• データの更新：PATCH または PUT メソッドを使用してデータを更新します。
• データの削除：DELETE リクエストをサポートします。

ファイル操作

• ファイルのアップロード：指定されたフィールドにファイルを添付します。
• ファイルのダウンロード：URL を介して添付ファイルをダウンロードします。
• 添付ファイルの管理：添付ファイルの追加、削除、置換を行います。

レポート実行

• レポートの実行：Quickbase レポートをトリガーし、結果を取得します。
• 出力の処理：レポート出力を解析して後続の操作を行います。

環境変数

エラー処理

エラーの種類

• 入力エラー：パラメータの形式が正しくありません。
• 認証エラー：無効なトークンまたは権限不足です。
• ネットワークエラー：Quickbase サービスに接続できません。

対処法

• ログファイルを確認して詳細なエラー情報を取得します。
• 認証情報と環境変数が正しく設定されていることを確認します。
• ネットワーク問題の場合は、インターネット接続を確認します。

貢献ガイド

コミュニティの皆さんからのプロジェクト開発への参加を歓迎します！以下は貢献の手順です。

1. リポジトリをフォークする：GitHub でこのプロジェクトをフォークします。
2. ブランチを作成する：新しい機能または修正のために新しいブランチを作成します。
3. 変更をコミットする：コードの変更をコミットし、詳細な説明を追加します。
4. Pull Request を作成する：あなたのブランチを元のリポジトリにプッシュして PR を作成します。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。具体的な内容は以下の通りです。

MIT License

さらなる情報が必要な場合は、GitHub リポジトリをご覧いただくか、メンテナンスチームにご連絡ください。