Nocodb MCP Server

🚀 Nocodb MCP 服務器文檔

Nocodb MCP 服務器提供了對數據進行操作和管理的功能，支持增刪改查、表結構管理等操作，同時具備完善的 API 接口和安全機制，能幫助用戶高效、安全地處理數據。

🚀 快速開始

下載與安裝

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 服務器的安全性和高效運行。