Grist MCP Server

基本能力

产品定位

Grist MCP Server 是一个用于与 Grist API 交互的 MCP 服务器实现，旨在实现 Grist 电子表格与语言模型之间的集成。

核心功能

• 直接从语言模型访问 Grist 数据
• 列出组织、工作区、文档、表格和列
• 查询、添加、更新和删除 Grist 表中的记录
• 具有丰富查询能力的过滤和排序数据
• 基于 API 密钥的安全认证

适用场景

• 分析和总结 Grist 数据
• 以编程方式创建、更新和删除记录
• 基于 Grist 数据构建报告和可视化
• 回答存储在 Grist 表中的数据问题
• 将 Grist 与语言模型连接以进行自然语言查询

工具列表

1. list_organizations: 列出用户有权访问的所有 Grist 组织。
2. list_workspaces: 列出 Grist 组织中的所有工作区。
3. list_documents: 列出 Grist 工作区中的所有文档。
4. list_tables: 列出 Grist 文档中的所有表格。
5. list_columns: 列出 Grist 表格中的所有列。
6. list_records: 列出 Grist 表中的记录，支持过滤、排序和限制。
7. add_grist_records: 向 Grist 表中添加记录。
8. update_grist_records: 更新 Grist 表中的记录。
9. delete_grist_records: 从 Grist 表中删除记录。

常见问题解答

无

使用教程

使用依赖

• Python 3.8+
• 有效的 Grist API 密钥
• 以下 Python 包: fastmcp, httpx, pydantic, python-dotenv

安装教程

1. 创建 .env 文件并添加以下内容:

GRIST_API_KEY=your_api_key_here
GRIST_API_HOST=https://docs.getgrist.com/api

1. 使用 pip 安装:

pip install mcp-server-grist

1. 或手动安装:

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

调试方式

1. 使用 Docker 构建:

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

1. 配置 Claude Desktop:

{
  "mcpServers": {
    "grist-mcp": {
      "command": "python",
      "args": [
        "-m", "grist_mcp_server"
      ]
    }
  }
}

或

{
  "mcpServers": {
    "grist-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "GRIST_API_KEY=your_api_key_here",
        "-e", "GRIST_API_HOST=https://docs.getgrist.com/api",
        "mcp/grist-mcp-server"
      ]
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。