表格管理服务器

一个强大的Google Sheets API集成服务器,支持创建、读取、更新和管理Google表格,适用于AI助手和自动化流程。

  • by lkm1developer
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 lkm1developer/google-sheets-mcp-server

使用说明

Google表格MCP服务器

强大的模型上下文协议(MCP)服务器实现,用于无缝集成Google Sheets API,使人工智能助手能够创建、读取、更新和管理Google Sheets。

特性

  • 创建、阅读、更新和删除Google表格
  • 使用单元格级操作管理工作表数据
  • 设置单元格和范围的格式
  • 与其他用户共享电子表格
  • 搜索电子表格
  • 全面的身份验证选项

身份验证选项

此MCP服务器支持多种身份验证方法:

  1. 服务帐户身份验证 (推荐用于生产)

    • 提供服务帐户密钥文件的路径
    • 或者直接提供服务帐户JSON内容
  2. API密钥验证 (更便于开发)

    • 提供Google API密钥
  3. OAuth2身份验证 (用于用户特定操作)

    • 提供OAuth客户端ID、客户端密钥和刷新令牌

设置

先决条件

  • Node.js(v16或更高版本)
  • 启用Google Sheets API的Google云项目
  • 身份验证凭据(见下文)

安装

  1. 克隆存储库:

    git clone https://github.com/yourusername/google-sheets-mcp-server.git
    cd google-sheets-mcp-server
    
  2. 安装依赖项:

    npm install
    
  3. 设置身份验证:

    • 创建一个 .env 文件基于 .env.example 模板
    • 添加您的Google Cloud凭据
  4. 构建项目:

    npm run build
    
  5. 启动服务器:

    npm start
    

OAuth设置

对于需要用户同意的操作(如创建/编辑电子表格),您需要OAuth凭据:

  1. 在Google Cloud控制台中创建OAuth凭据
  2. 更新 CLIENT_ID 和 CLIENT_SECRET 在……里面 src/get-refresh-token.js
  3. 安装所需的依赖项:
    npm install open server-destroy
    
  4. 运行脚本以获取刷新令牌:
    node src/get-refresh-token.js
    
  5. 按照浏览器提示授权应用程序
  6. 将刷新令牌复制到您的 .env 文件

可用工具

服务器提供以下工具:

  • google_sheets_create:创建新的Google表格
  • google_sheets_get:按ID获取谷歌表格
  • google_sheets_update_values:更新Google表格中的值
  • google_sheets_append_values:将值附加到Google工作表
  • google_sheets_get_values:从谷歌表格中获取值
  • google_sheets_clear_values:从Google表格中清除值
  • google_sheets_add_sheet:将新工作表添加到现有电子表格中
  • google_sheets_delete_sheet:从电子表格中删除工作表
  • google_sheets_list:列出经过身份验证的用户可以访问的Google表格
  • google_sheets_delete:删除Google工作表
  • google_sheets_share:与特定用户共享Google表格
  • google_sheets_search:按标题搜索谷歌表格
  • google_sheets_format_cells:设置Google工作表中的单元格格式
  • google_sheets_verify_connection:验证与Google Sheets API的连接

示例用法

以下是如何将此MCP服务器与Claude一起使用的示例:

You can now use Google Sheets! Try these commands:

1. Create a new spreadsheet:
   "Create a new Google Sheet titled 'Monthly Budget'"

2. Add data to the spreadsheet:
   "Add expense categories and amounts to my Monthly Budget spreadsheet"

3. Format the spreadsheet:
   "Format the header row to be bold and centered"

4. Share the spreadsheet:
   "Share my Monthly Budget spreadsheet with john@example.com"

许可证

麻省理工学院