使用说明

项目简介

claude-mcp (GRID MCP Server) 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接 Anthropic 的 Claude 桌面应用和 GRID API。通过这个服务器，用户可以直接在 Claude 中查询 GRID 电子表格中的数据，并生成图表，从而扩展 Claude 的数据处理和可视化能力。

主要功能点

电子表格数据查询：允许 Claude 查询 GRID 电子表格中的数据，并以 JSON 格式返回。
生成图表：支持 Claude 基于电子表格数据生成折线图和柱状图，并返回图表图片 (PNG) 或图表 URL。
工具集成：通过 MCP 协议将 GRID API 的功能封装为工具，供 Claude 调用。

安装步骤

安装 Claude 桌面应用、Node.js 和 Git：
- 确保已安装 Claude for Desktop, Node.js 和 Git。
注册 GRID 账号并获取 API 密钥：
- 前往 GRID 官网注册账号。
- 上传电子表格到 GRID。
- 在 API 密钥页面获取您的 API 密钥。

克隆仓库：

git clone https://github.com/GRID-is/claude-mcp.git

进入仓库目录：
```
cd claude-mcp
```
安装依赖：
```
npm install
```

服务器配置

要让 Claude 桌面应用连接到 claude-mcp 服务器，您需要编辑 Claude 的配置文件。

打开 Claude 配置文件 (如果文件不存在则创建)：
- MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
添加 MCP 服务器配置 到 'mcpServers' 键中：
```
{
  "mcpServers": {
    "grid": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/claude-mcp/dist/index.js"],
      "env": {
        "GRID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```
配置参数说明:
- '"grid"': 服务器名称，可以自定义。
- '"command": "node"': 启动服务器的命令，这里使用 Node.js 运行。
- '"args": ["/ABSOLUTE/PATH/TO/claude-mcp/dist/index.js"]': 启动命令的参数，指向 'claude-mcp' 仓库中编译后的 'index.js' 文件绝对路径。请将 '/ABSOLUTE/PATH/TO/claude-mcp' 替换为您本地仓库的实际绝对路径。
- '"env": { "GRID_API_KEY": "YOUR_API_KEY" }': 环境变量配置，用于设置 GRID API 密钥。请将 '"YOUR_API_KEY"' 替换为您在 GRID 官网获取的 API 密钥。
重启 Claude 桌面应用：退出并重新打开 Claude 桌面应用，配置即可生效。

基本使用方法

配置完成后，您就可以在 Claude 中使用自然语言查询您的 GRID 电子表格数据或生成图表了。

示例：

使用 workbook id 为 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' 的工作簿，给我 A1:C10 单元格的总和。

或者

使用 workbook id 为 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' 的工作簿，生成数据范围为 C2:C142，标签为 B2:B142，标题为 A1 的折线图。

请将 'workbook id' 替换为您实际的 GRID 电子表格 ID。

开发调试

如果您需要修改服务器代码，可以按照以下步骤进行开发：

安装依赖: 'npm install'
构建服务器: 'npm run build'
开发模式 (自动重建): 'npm run watch'
使用 MCP Inspector 调试: 'npm run inspector' (访问控制台输出的 URL 在浏览器中打开调试工具)

关键词