Nocodb MCP Server

🚀 Nocodb MCP サーバードキュメント

Nocodb MCP サーバーは、データ操作や表構造管理などの機能を提供するサーバーです。このドキュメントでは、サーバーのインストール、設定、機能の使い方、API の参照、セキュリティ対策などについて説明します。

🚀 クイックスタート

Nocodb MCP サーバーを使用するには、まずインストールと設定を行う必要があります。以下の手順に従って操作してください。

📦 インストール

ダウンロードとインストール

1. GitHub からコードリポジトリを取得する：

   git clone https://github.com/nocodb/mcp-server.git
   cd mcp-server
   

2. 依存関係をインストールする：

   pip install -r requirements.txt
   

3. 環境変数を設定する：
   • NOCODB_BASE_ID 環境変数を設定します。例えば：

     export NOCODB_BASE_ID=your_base_id
     

サーバーを起動する

python nocodb_mcp_server.py

✨ 主な機能

ツール機能

• データ操作：追加、削除、更新、検索の基本操作をサポートします。
• 表構造管理：表構造情報を取得する機能を提供します。
• 一括操作：単一および一括データ処理をサポートします。

💻 使用例

基本的な使用法

# 查询记录示例
print(json.dumps(find_records("customers", {"limit": 10})))

# 插入新记录示例
new_record = {"name": "张三", "email": "zhangsan@example.com"}
print(json.dumps(create_records("customers", [new_record])))

📚 ドキュメント

API リファレンス

基本 URL

• すべてのリクエストは https://api.nocodb.com/api/v2/ に向けられます。

リクエストヘッダーの設定

GET /tables/customers/records HTTP/1.1
Host: api.nocodb.com
xc-token: your_api_token

🔧 技術詳細

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

認証メカニズム

• xc-token リクエストヘッダーを使用して認証を行います。
• API トークンの安全性を確保し、漏洩を防いでください。

権限管理

• Nocodb の権限システムを通じてデータアクセスを制御します。
• API トークンの権限を定期的にレビューし、更新してください。

エラー処理

一般的なエラーコード

エラー応答の例

{
  "error": {
    "code": 401,
    "message": "认证失败"
  }
}

高度な機能

ログ記録

• デフォルトのログレベルは ERROR です。
• logging.basicConfig を調整することで、詳細なログ出力を設定できます。

一括操作の最適化

• bulk_ids パラメータを使用して、効率的な一括処理を実現します。
• データ転送の中断を避けるため、ネットワークの安定性を確保してください。

セキュリティのベストプラクティス

1. 最小権限の原則：必要最小限の権限を持つ API トークンを作成します。
2. 環境変数の管理：コード内に機密情報をハードコードせず、常に環境変数を使用します。
3. 監査ログ：Nocodb の監査機能を有効にして、データ操作を監視します。
4. 定期的なレビュー：API トークンとその権限を定期的にチェックし、更新します。

これらのガイドラインに従うことで、Nocodb MCP サーバーの安全性と効率的な運用を確保できます。