UNICLOUDDB-MCP

UniCloudDB-MCP

MCP プロトコルに基づいた uniCloud データベース操作ツールで、AI アシスタントを通じたデータベース CRUD 操作に対応しています。

機能

• 標準化された MCP プロトコルツール統合に対応
• 完全な JQL フォーマットデータベース操作インターフェイスを提供
• クエリ、追加、更新、削除などの一般的な操作に対応
• シンプルで使いやすい API デザイン
• 主流の AI モデルツール呼び出しに対応
• ローカルでの実行に対応し、ソースコードの修正が可能

MCP を直接設定して使用する

{
 "uniclouddb-mcp": {
    "command": "npx",
    "args": ["-y", "uniclouddb-mcp"],
    "env": {
      "DB_SERVICE_URL": "https://你的uniCloud云函数URL.next.bspapp.com/mcp"
    }
  }
}

ローカル実行の使用方法

インストール

npm install uniclouddb-mcp

環境変数の設定

環境変数によってデータベースサービスパラメータを設定できます：

# config 文件
DB_SERVICE_URL=https://你的uniCloud云函数URL/mcp
REQUEST_TIMEOUT=30000

mcp_service フォルダを自分のプロジェクトの uniCloud/cloudfunctions ディレクトリにコピーして、クラウド関数をアップロードします

uniCloud ウェブコンソールを開き、mcp_service クラウド関数を見つけて、クラウド関数の URL 化を設定します

HTTP または HTTPS でこのクラウド関数にアクセスするための URL を設定します。ドメインはクラウド関数リスト画面で バインドされます。ここでは path のみを設定します。参考ドキュメント: https://uniapp.dcloud.io/uniCloud/http

MCP service を設定する

{
 "uniclouddb": {
      "name": "uniclouddb",
      "key": "uniclouddb",
      "command": "node",
      "args":[
        "D:\\uniCloudDB-mcp\\index.js"
      ],
      "disabled": false,
      "env": {}
  }
}

MCP ツールの説明

本ライブラリは以下の MCP ツールを提供し、AI アシスタントから直接呼び出すことができます：

1. query - データをクエリする

パラメータ：

• collection: コレクション名
• where: クエリ条件（JQL フォーマット）
• field（オプション）: 返すフィールド
• limit（オプション）: 返す数の制限
• skip（オプション）: スキップするレコード数
• orderBy（オプション）: ソート条件

2. add - データを追加する

パラメータ：

• collection: コレクション名
• data: 追加するデータ（object/array）

3. update - データを更新する

パラメータ：

• collection: コレクション名
• where: 更新条件（JQL フォーマット）
• data: 更新するデータ（object）

4. remove - データを削除する

パラメータ：

• collection: コレクション名
• where: 削除条件（JQL フォーマット）

データベース接続テスト

組み込みテストツールを使用してデータベース接続と基本機能を検証します：

npm test

システム要件

• Node.js >= 18.0.0
• デプロイ済みの uniCloud クラウド関数

uniCloud クラウド関数統合

本ツールは uniCloud クラウド関数と組み合わせて使用する必要があります。対応する処理関数がデプロイされていることを確認してください。 クラウド関数は標準 JQL フォーマットのリクエストを受け取り、データベース操作を処理して結果を返します。

セキュリティに関する注意

• 本番環境ではアクセス制御と認証の設定をお勧めします
• 公開環境でデータベース URL を公開しないようにしてください
• 潜在的なセキュリティ問題を修正するため、依存パッケージを定期的に更新してください

ライセンス

MIT