MCP Server Grist

🚀 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 .

手動インストール

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

📄 ライセンス

このMCPサーバーはMIT Licenseの下で提供されています。