MCP Server Grist

🚀 Grist MCP 服務器

Grist MCP 服務器是一個實現 Grist API 交互的工具，它搭建起了 Grist 電子表格與語言模型之間的橋樑，讓二者的集成變得輕鬆簡單。

✨ 主要特性

• 語言模型可直接訪問 Grist 數據。
• 能夠列出組織、工作區、文檔、表和字段。
• 支持對 Grist 表中的記錄進行查詢、添加、更新和刪除操作。
• 具備豐富的查詢功能，可進行過濾和排序。
• 採用基於 API 密鑰的安全認證機制。

📚 詳細文檔

工具介紹

list_organizations

• 功能：列出用戶可訪問的所有 Grist 組織。
• 返回：包含 ID、名稱和域名的組織列表。

list_workspaces

• 功能：列出 Grist 組織中的所有工作區。
• 輸入：
  • org_id (int 或 string)：要列出工作區的組織 ID。
• 返回：包含 ID 和名稱的工作區列表。

list_documents

• 功能：列出 Grist 工作區中的所有文檔。
• 輸入：
  • workspace_id (int)：要列出文檔的工作區 ID。
• 返回：包含 ID 和名稱的文檔列表。

list_tables

• 功能：列出 Grist 文檔中的所有表。
• 輸入：
  • doc_id (string)：文檔的 ID，其中包含要列出的表。
  • table_id (string)：要列出字段的表 ID。
• 返回：包含 ID 和字段數據的列列表。

list_records

• 功能：根據可選過濾、排序和限制條件列出 Grist 表中的記錄。
• 輸入：
  • doc_id (string)：文檔的 ID，其中包含表。
  • table_id (string)：要列出記錄的表 ID。
  • filter_json (string, 可選)：過濾記錄的 JSON 字符串（例如：{"column_name": ["value1", "value2"]}）。
  • sort (string, 可選)：按逗號分隔的排序列列表（前綴為'-'表示降序）。
  • limit (int, 可選)：最大返回記錄數。
• 返回：包含 ID 和字段數據的記錄列表。

add_grist_records

• 功能：向 Grist 表中添加記錄。
• 輸入：
  • doc_id (string)：文檔的 ID，其中包含表。
  • table_id (string)：要添加記錄的表 ID。
  • records (array)：要添加的記錄列表（每個記錄為字段值字典）。
• 返回：新創建記錄的 ID 列表。

update_grist_records

• 功能：更新 Grist 表中的記錄。
• 輸入：
  • doc_id (string)：文檔的 ID，其中包含表。
  • table_id (string)：要更新記錄的表 ID。
  • records (array)：要更新的記錄列表（每個記錄為字段值字典）。
• 返回：成功更新的記錄數量。

delete_grist_records

• 功能：從 Grist 表中刪除記錄。
• 輸入：
  • doc_id (string)：文檔的 ID，其中包含表。
  • table_id (string)：要刪除記錄的表 ID。
  • records (array)：要刪除的記錄列表（每個記錄為字段值字典）。
• 返回：成功刪除的記錄數量。

📦 安裝指南

Docker 安裝

docker build -t mcp/grist-mcp-server .

常規安裝

可以選擇使用 pip 安裝，或者手動克隆倉庫安裝：

pip install mcp-server-grist

手動安裝步驟如下：

git clone https://github.com/yourusername/mcp-server-grist.git
cd mcp-server-grist
pip install -r requirements.txt

📄 許可證

此 MCP 服務器根據 MIT License 授權。