Grist Darcy MCP

MCP数据服务

提供方 elmunoz42

数据服务 stdio · 本地进程 API Key 社区 / 第三方
查看接入方式

一个基于SQLite的自托管Grist电子表格/数据库平台,支持Docker容器化部署,适用于AWS EC2。

一句话选型结论

按资料字段整理

Grist Darcy MCP 属于数据服务类 MCP 服务器,stdio · 本地进程,API Key,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

电子表格Python本地部署数据库自托管DockerAWSEC2

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
python3 -c "import secrets; print(secrets.token_urlsafe(32))"

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Grist Darcy MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方elmunoz42上游标注的维护方 elmunoz42
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.2 KB
来自项目仓库与上游目录的原文,未做删改

Grist with SQLite-EC2部署

使用SQLite进行数据存储的自托管Grist电子表格/数据库平台,与Docker容器化,可用于AWS EC2部署。


Grist是什么?

Grist是一个现代的开源电子表格数据库混合体,将电子表格的灵活性与数据库的强大功能相结合。它非常适合:

  • 无需代码即可构建自定义应用程序
  • 使用关系管理结构化数据
  • 创建表单和仪表板
  • API驱动的数据工作流
  • 协作团队工作空间

建筑

此部署使用:

  • 格里斯特:Docker Hub的最新稳定版本
  • SQLite:默认嵌入式数据库(不需要外部数据库)
  • Docker Compose:容器编排
  • 持久容量:数据存储在本地 ./persist 目录

数据存储

SQLite数据库创建于 /persist 目录:

  • home.sqlite3 -用户、工作区和文档元数据
  • grist-sessions.db -浏览器会话数据
  • docs/*.grist -单个Grist文档(也包括SQLite文件)

特性

  • 零数据库设置:SQLite开箱即用,不需要PostgreSQL/MySQL
  • 轻松部署:单人 docker compose up 命令
  • 持久化存储:所有数据在容器重启后仍然有效
  • 便携的:通过复制进行备份/还原 persist/ 目录
  • 可扩展的:如果需要,稍后升级到PostgreSQL
  • 安全:会话机密,单端口模式,可选HTTPS
  • MCP服务器:用于AI助手集成的模型上下文协议服务器(参见 MCP_SERVER.md)

先决条件

  • AWS EC2实例(建议使用Ubuntu 22.04 LTS)
  • 已安装Docker和Docker Compose
  • 开放端口:22(SSH),80/443(HTTP/HTTPS)
  • 对于强化部署,请保持 8484 公开关闭,仅通过Nginx。

快速启动(地方发展)

1.克隆存储库```bash

git clone
cd grist-sqlite-ec2


### 2.创建环境文件```bash
cp .env.example .env

3.生成会话密钥```bash

python3 -c "import secrets; print(secrets.token_urlsafe(32))"


### 4.编辑.env```bash
nano .env

设置所需值:```bash
GRIST_SESSION_SECRET=
GRIST_DEFAULT_EMAIL=your-email@example.com
GRIST_DOMAIN=localhost
PORT=8484


### 5.启动Grist```bash
docker compose up -d

6.进入Grist

打开浏览器: http://localhost:8484


EC2部署

看 EC2_部署.md 获取完整的分步指南,包括:

  • EC2实例设置
  • Docker安装
  • 安全配置
  • 自定义域和HTTPS
  • 自动备份
  • 生产检查表

快速EC2部署:```bash

SSH to EC2

ssh -i your-key.pem ubuntu@your-ec2-ip

Install Docker

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker ubuntu
newgrp docker

Clone and setup

git clone grist-sqlite-ec2
cd grist-sqlite-ec2
cp .env.example .env
nano .env # Configure values

Start Grist

docker compose up -d

Access

https://your-domain


______________________________________________________________________

## 配置

### 环境变量

#### 必需的

- `GRIST_SESSION_SECRET` -会话管理密钥(用Python脚本生成)
- `GRIST_DEFAULT_EMAIL` -初始管理员帐户的电子邮件

#### 可选的

- `PORT` -服务器端口(默认值:8484)
- `GRIST_DOMAIN` -域名或IP地址
- `GRIST_SANDBOX_FLAVOR` -插件沙箱安全(gvisor、unsandboxed、pyodide)

看 `.env.example` 查看完整配置选项。

______________________________________________________________________

## 用法

### 基本操作

#### 开始Grist```bash
docker compose up -d

阻止格里斯特```bash

docker compose down


#### 重新启动Grist```bash
docker compose restart

查看日志```bash

docker compose logs -f


#### 检查状态```bash
docker compose ps

用户管理

  1. 第一个用户(使用 GRIST_DEFAULT_EMAIL)自动成为管理员
  2. 管理员可以通过Grist UI邀请用户
  3. 用户通过邀请链接创建帐户

数据管理

备份数据```bash

Backup entire persist directory

tar -czf grist-backup-$(date +%Y%m%d).tar.gz ./persist

Or copy SQLite files directly

cp -r ./persist ~/grist-backup


#### 恢复数据```bash
# Stop Grist
docker compose down

# Restore files
tar -xzf grist-backup-YYYYMMDD.tar.gz

# Start Grist
docker compose up -d

检查数据库大小```bash

du -sh ./persist


______________________________________________________________________

## Docker命令

### 将Grist更新到最新版本```bash
docker compose pull
docker compose up -d

查看容器详细信息```bash

docker inspect grist-app


### 在容器中执行命令```bash
docker exec -it grist-app bash

清理旧图像```bash

docker system prune -a


______________________________________________________________________

## 故障排除

### 容器无法启动

**检查日志:**```bash
docker compose logs

常见问题:

  • 缺失 .env file → 创建自 .env.example
  • 端口8484已在使用中→ 改变 PORT 在 .env
  • 权限错误→ Run chmod -R 755 ./persist

无法访问Grist

来自EC2:```bash
curl http://localhost:8484


**如果本地工作但不远程工作:**

- 检查EC2安全组是否允许端口80/443
- 检查防火墙: `sudo ufw status`
- 验证 `GRIST_DOMAIN` 匹配您的访问URL

### 数据库错误

**检查SQLite的完整性:**```bash
sqlite3 ./persist/home.sqlite3 "PRAGMA integrity_check;"

重置数据库(警告:删除所有数据):```bash
docker compose down
rm -rf ./persist/*
docker compose up -d


### 性能问题

**检查系统资源:**```bash
docker stats grist-app

升级实例类型或优化:

  • 使用t3.small或更大的尺寸进行生产
  • 监控磁盘I/O iostat
  • 考虑PostgreSQL用于高负载场景

安全

会话机密

  • 总是 生成强随机秘密
  • 永不承诺 .env 到版本控制
  • 定期轮换机密

防火墙配置```bash

sudo ufw allow 22/tcp # SSH only
sudo ufw allow 80/tcp # HTTP
sudo ufw allow 443/tcp # HTTPS
sudo ufw enable


### HTTPS设置

- 使用Nginx作为反向代理
- 安装Let's Encrypt SSL证书
- 将HTTP重定向到HTTPS
- 看 **EC2_部署.md** 详细设置

### 文件权限```bash
chmod 600 .env                    # Only owner can read/write
chmod -R 755 ./persist            # Container can read/write data

生产建议

  1. 使用HTTPS:始终加密生产中的流量
  2. 定期备份:将日常备份自动化到S3或外部存储
  3. 监控日志:设置日志聚合(CloudWatch、ELK堆栈)
  4. 资源监控:跟踪CPU、内存、磁盘使用情况
  5. 定期更新:保持Grist和Docker映像的最新状态
  6. 限制访问:使用安全组限制传入流量
  7. 测试恢复:定期验证备份完整性

升级到PostgreSQL(可选)

如果你无法使用SQLite,请迁移到PostgreSQL:

  1. 导出Grist数据
  2. 设置PostgreSQL(RDS或自托管)
  3. 更新 docker-compose.yml 与PostgreSQL连接
  4. 重新启动Grist并导入数据

有关迁移指南,请参阅Grist文档。


项目结构```

grist-sqlite-ec2/
├── docker-compose.yml # Docker Compose configuration
├── .env.example # Environment template
├── .env # Environment configuration (gitignored)
├── .gitignore # Git ignore rules
├── README.md # This file
├── MCP_SERVER.md # MCP server documentation
├── EC2_DEPLOYMENT.md # Detailed EC2 setup guide
├── persist/ # Persistent data directory (gitignored)
│ ├── home.sqlite3 # Users, workspaces, docs metadata
│ ├── grist-sessions.db # Session data
│ └── docs/ # Individual .grist files
└── mcp-server/ # MCP server for AI assistant integration
├── server.py # FastAPI MCP server
├── grist_client.py # Grist REST API client
├── tools.py # MCP tools for Grist operations
├── requirements.txt # Python dependencies
├── .env.example # MCP server environment template
├── .gitignore # Git ignore rules
└── tests/ # Test suite
├── test_grist_client.py
├── test_tools.py
└── test_integration.py


______________________________________________________________________

## MCP服务器集成

此部署包括一个模型上下文协议(MCP)服务器,允许AI助手(如DarcyIQ):

- 列出Grist文档中的表格
- 读取和查询记录数据
- 创建新记录
- 更新现有记录
- 删除记录
- 通过自然语言自动化数据工作流程

看 **MCP_SERVER.md** 获取完整的设置和集成指南。

**快速MCP设置:**```bash
cd mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Configure Grist API key and MCP auth token in .env
python server.py

MCP服务器通过REST API连接到Grist实例,并提供与DarcyIQ和其他人工智能助手兼容的JSON-RPC 2.0接口。


资源

文档

  • Grist Docs: https://support.getgrist.com/
  • 自我管理指南: https://support.getgrist.com/self-managed/
  • API文档: https://support.getgrist.com/api/

码头工人

  • Docker 中心: https://hub.docker.com/r/gristlabs/grist
  • GitHub: https://github.com/gristlabs/grist-core

社区

  • 论坛: https://community.getgrist.com/

贡献

欢迎投稿!拜托:

  1. 分叉存储库
  2. 创建要素分支
  3. 本地测试更改
  4. 提交拉取请求

许可证

[您的许可证在这里]


支持

  • 问题:查看上面的故障排除部分
  • EC2设置:参见 EC2_部署.md
  • Grist帮助:参观https://support.getgrist.com/

快速参考卡

首次设置```bash

cp .env.example .env
nano .env # Set GRIST_SESSION_SECRET and GRIST_DEFAULT_EMAIL
docker compose up -d


### 日常运营```bash
docker compose ps          # Check status
docker compose logs -f     # View logs
docker compose restart     # Restart

备份与恢复```bash

Backup

tar -czf backup.tar.gz ./persist

Restore

docker compose down
tar -xzf backup.tar.gz
docker compose up -d


### 更新```bash
docker compose pull
docker compose up -d

创建:2026年1月22日
状态:准备部署

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Grist Darcy MCP 怎么安装?

在客户端按下面的安装命令接入:python3 -c "import secrets; print(secrets.token_urlsafe(32))"。装完在客户端配置里引用同一个包或端点。

Grist Darcy MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Grist Darcy MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Grist Darcy MCP 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Grist Darcy MCP 能提供哪些能力?

资料显示能力标签包括 数据库、Python、自托管。具体工具清单以官方文档为准。

Grist Darcy MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Grist Darcy MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。