文档管理服务器

Grist MCP Server 是一个用于创建和管理文档、工作区及表格的服务,适用于个人财务跟踪和组织管理。

  • by Quentinchampenois
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 Quentinchampenois/grist-go-mcp

使用说明

Grist MCP服务器

[⚠️] 工作正在进行中,尚未准备好投入生产。
[⚠️] TODO:必须尽量减少提示和响应,以限制令牌的使用(示例请求约8000个令牌)
[⚠️] 免责声明:这只是一个有趣的项目,不积极维护,但很乐意分享,欢迎投稿!

功能:

  • ✅ list_orgs :列出所有组织
  • ✅ create_workspace:在组织中创建新的工作区
  • ✅ create_new_docs:在工作区中创建一个或多个文档
  • ✅ create_new_tables:向文档中添加带列的新表
  • ☑️ query_sql:查询SQL(API尚不可用)
  • ☑️ add_record:在文档中添加记录(API尚不可用)
  • ☑️ get_record:在文档中获取记录(API尚不可用)

示例

系统提示示例可在 docs/SYSTEM_PROMPT.md

提示:

在Grist中创建一个具有以下结构的个人财务跟踪器:

  1. 所需表格:
    -交易:日期、描述、类别、金额、付款方式和注释列
    -类别:类别名称、类型(收入/支出)、预算限额列
    -月度摘要:月份、总收入、总支出、净余额列

入门

  1. 克隆项目
$ git clone https://github.com/quentinchampenois/grist-mcp.git 
$ cd grist-mcp
  1. 构建服务器
$ go mod tidy
$ go build -o grist-mcp-server

💡 二进制 grist-mcp-server 必须出席 $PATH 可调用

🚀 MCP服务器已准备就绪!但是怎么做?
如果你试图直接运行它 $ ./grist-mcp-server 进程将运行,但不会发生任何事情,这是预期的行为。

使用@modelcontextprotocol/inspector进行调试

包裹 @modelcontextprotocol/inspector 启动WebUI直接测试MCP服务器,根据提供的输入测试输出。

需求

  • 节点

如何

按照以下步骤启动检查器

$ npx @modelcontextprotocol/inspector grist-mcp-server

访问WebUIhttp://localhost:6274/?MCP_PROXY_AUTH_TOKEN=<生成令牌>

使用Cherry studio和Scaleway AI提供程序配置客户端

在这个例子中,我们将使用 樱桃工作室 作为客户和 Scaleway提供商提供的qwen3-235b-a22b-struct-2507模型.

需求

  • 在Scaleway上配置帐户并生成API令牌(约5分钟)
  • 樱桃工作室安装

在Cherry Studio的Scaleway中配置Qwen3-235b

打开Cherry Studio并配置Scaleway提供程序:(cf:README on 另一个完整的奇瑞工作室步骤项目) 💡 非常重要的是,在cherry studio MCP配置中设置环境变量:

  • GRIST_ENDPOINT=http://localhost:8484
  • GRIST_API_KEY=<YOUR_API_KEY>,来自GRIST WebUI的API_KEY

🚀 一旦Cherry工作室,让我们尝试一下基本提示

I want to manage my tennis club within Grist, including: members, available fields and hours of lessons. 

You must create in Grist : 
* 1 new workspace in my Grist organization
* 3 documents in this newly created workspace

例子:

提示:

结果:

额外

  • 来源Cherry工作室:https://github.com/CherryHQ/cherry-studio
  • 源Scaleway AI(生成型API):https://www.scaleway.com/en/docs/generative-apis/quickstart/
  • 去MCP SDK:https://github.com/modelcontextprotocol/go-sdk/tree/main
  • MCP检查员:https://modelcontextprotocol.io/docs/tools/inspector