使用说明
Google表格MCP服务器
该项目实现了一个模型上下文协议（MCP）服务器，允许人工智能助手（如Gemini、Cursor、Claude）与GoogleSheetsneneneba API交互。
🚀 现在有了多用户支持和强大的隔离！
它遵循双服务器架构：
- 内部Google Sheets API服务器 （端口3001）：处理OAuth2、令牌管理（Subabase）和直接API调用。
- MCP HTTP服务器 （端口3000）：将Google表格功能作为MCP工具公开。
主要特点
- 多用户支持：每个用户都通过Supabase拥有自己的隔离令牌存储。
- 自动生成的MCP令牌：在Google OAuth登录时自动生成的安全令牌。
- 严格身份验证：API访问需要有效的MCP令牌；没有默认回退。
- 综合工具集：创建、阅读、更新和管理电子表格。
架构概述
┌───────────────────────┐ ┌───────────────────────┐
│ LLM Client │ │ Supabase │
│ (Cursor, Gemini, etc.)│ │ (Token Storage) │
└───────────┬───────────┘ └───────────▲───────────┘
│ │
│ JSON-RPC / stdio │
▼ │
┌───────────────────────┐ │
│ MCP Protocol Wrapper │ │
└───────────┬───────────┘ │
│ HTTP │
▼ │
┌───────────────────────┐ ┌───────────▼───────────┐
│ MCP HTTP Server │──────►│ Internal API Server │
│ (Port 3000) │ HTTP │ (Port 3001) │
└───────────────────────┘ └───────────┬───────────┘
│
│ Google API
▼
┌───────────────────────┐
│ Google Sheets API │
└───────────────────────┘
快速开始
先决条件
- Node.js v18+
- Supabase项目
- 谷歌云项目（OAuth凭据）
安装
-
克隆和安装：
git clone <repo> cd google-sheets-mcp-server npm install -
配置环境： 创建
.env（参见DOCS/MCP_SETUP.md详细信息）。 -
设置数据库： 跑
supabase/schema.sql在您的Supabase SQL编辑器中。 -
启动服务器：
npm start -
身份验证： 访问
http://localhost:3001/auth/url登录并获取您的 MCP令牌. -
配置客户端： 将MCP服务器添加到您的客户端配置中，并生成
MCP_TOKEN.
👉 详细设置指南
文档
贡献
看 贡献.md 作为指导方针。