クイックベース MCP サーバー
Quickbase 用の TypeScript ベースの Model Context Protocol (MCP) サーバー。Claude Desktop やその他の AI アシスタントとのシームレスな統合を目的として設計されています。
📋 コミュニティプロジェクトのお知らせ
これはコミュニティによって開発された統合機能であり、Quickbaseの公式製品ではありません。Quickbaseの公開APIを使用していますが、Quickbase, Inc.による公式サポートは受けていません。このプロジェクトは「現状有姿」で提供され、コミュニティによって維持されています。Quickbaseの公式製品とサポートについては、 quickbase.comをご覧ください。
🚀 Claude デスクトップのクイックスタート
ワンラインセットアップチェック
Claudeデスクトップの設定
Claude Desktop 構成ファイルに以下を追加します。
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json
これで完了です。Claude Desktop を再起動すると、Quickbase ツールの使用を開始できます。
Related MCP server: Database Tools for Claude AI
📦 インストールオプション
オプション 1: NPM (推奨)
オプション2: ソースから
ソース インストールの場合は、次の Claude Desktop 構成を使用します。
🔧 構成
環境変数が設定されていなくてもサーバーcheck_configuration起動できますが、適切な設定が行われるまでツールは機能しません。check_configurationツールを使用して設定を確認してください。
必要な環境変数
QUICKBASE_REALM_HOST- Quickbase レルム (例:company.quickbase.com)QUICKBASE_USER_TOKEN- Quickbase API トークン (こちらから取得)
オプションの環境変数
QUICKBASE_APP_ID- デフォルトのアプリケーションID
オプション設定
QUICKBASE_CACHE_ENABLED- キャッシュを有効にする (true/false、デフォルト:true)QUICKBASE_CACHE_TTL- キャッシュ期間(秒)(デフォルト:3600)DEBUG- デバッグログを有効にする(true/false、デフォルト:false)LOG_LEVEL- ログレベル(DEBUG/INFO/WARN/ERROR、デフォルト:INFO)
🛠️ 利用可能なツール
接続と構成
check_configuration- Quickbaseの設定が正しく設定されているか確認するtest_connection- Quickbaseへの接続をテストするconfigure_cache- キャッシュ動作を設定する
アプリケーション管理
create_app- 新しい Quickbase アプリケーションを作成するupdate_app- 既存のアプリケーションを更新するlist_tables- アプリケーション内のすべてのテーブルを一覧表示する
テーブル操作
create_table- 新しいテーブルを作成するupdate_table- テーブルのプロパティを更新するget_table_fields- テーブルのフィールド情報を取得する
フィールド管理
create_field- テーブルに新しいフィールドを作成するupdate_field- フィールドのプロパティを更新する
レコード操作
query_records- フィルタリングと並べ替えによるレコードのクエリcreate_record- 単一のレコードを作成するupdate_record- 既存のレコードを更新するbulk_create_records- 複数のレコードを作成するbulk_update_records- 複数のレコードを更新する
ファイル操作
upload_file- ファイル添付フィールドにファイルをアップロードするdownload_file- レコードからファイルをダウンロードする
報告
run_report- Quickbaseレポートを実行する
📚 使用例
基本レコードクエリ
新しいレコードを作成する
ファイルをアップロードする
🔒 セキュリティ
APIトークンは安全に処理され、ログに記録されることはありません
すべてのファイル操作は作業ディレクトリにサンドボックス化されます
フィールドレベルの権限とアクセス制御をサポート
📋 要件
Node.js 18以上
APIアクセスが可能な有効なQuickbaseアカウント
Claude Desktop(MCP統合用)
🤝 貢献する
貢献を歓迎します!お気軽にプルリクエストを送信してください。
📄 ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。