DocuGen-谷歌表格MCP服务器
使用模型上下文协议（MCP）的Claude Desktop强大的Google表格自动化服务器。创建电子表格、分析数据、构建仪表板，并通过62个操作自动化工作流程。
🚀 什么是DocuGen？
DocuGen使Claude能够以编程方式创建和操作Google表格。与其手动点击电子表格，不如用简单的英语告诉克劳德你需要什么：
- “为我的个人财务创建预算跟踪器”
- “导入此CSV数据并创建销售仪表板”
- “构建具有再订购警报的库存管理系统”
✨ 特性
62谷歌表格操作
- 电子表格管理：创建、批量更新、获取元数据
- 数据操作：读取、写入、追加、清除、导入CSV/JSON
- 格式化：单元格样式、边框、合并、条件格式
- 高级功能：数据透视表、图表、数据验证、过滤器
- 表单管理：添加、删除、复制、重命名、隐藏/显示工作表
- 保护：锁定范围、保护工作表、管理权限
- 公式：添加复杂公式、命名范围、计算
智能模板
- 带有收入/支出类别的预算跟踪器
- 带有KPI和图表的财务仪表板
- 使用甘特图进行项目管理
- 具有自动重新订购警报的库存系统
- 具有联系人和交易跟踪功能的CRM系统
- 活动策划模板
- 带有摊销计划的贷款计算器
📋 先决条件
- Python 3.12或更高版本
- Google Cloud帐户（免费版有效）
- Claude桌面应用程序
- 5分钟用于设置
🛠️ 安装
步骤1：克隆并安装
# Clone the repository
git clone https://github.com/eagleisbatman/docugen.git
cd docugen
# Create virtual environment (recommended)
python3.12 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
pip install git+https://github.com/modelcontextprotocol/python-sdk.git步骤2：设置Google OAuth
- 首选 谷歌云控制台
- 创建新项目（或使用现有项目）
- 启用 谷歌网页API:
- 导航到“API和服务”>“库” - 搜索“Google Sheets API” - 单击并启用它
- 创建OAuth 2.0凭据：
- 转到“API和服务”>“凭据” - 点击“创建凭据”>“OAuth客户端ID” - 选择“桌面应用程序”作为应用程序类型 - 下载JSON文件 - 将其保存在安全的地方（例如。， ~/Desktop/credentials.json)
步骤3：配置Claude桌面
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"docugen": {
"command": "python3.12",
"args": [
"/absolute/path/to/docugen/docugen_mcp_server.py"
],
"env": {
"GOOGLE_OAUTH_PATH": "/path/to/your/credentials.json"
}
}
}
}用实际路径替换路径！
步骤4:重新启动克劳德桌面
完全退出并重新启动Claude Desktop。您应该看到MCP图标(🔌) 在聊天界面中。
步骤5：（推荐）设置DocuGen项目
为了获得最佳效果，请在Claude Desktop中创建一个专用项目：
- 在Claude Desktop中，创建一个新项目
- 转到项目设置→ 客户指令
- 从以下位置复制内容 DOCUGEN_SYSTEM_PROMPT.md
- 将其粘贴到项目说明中
- 将项目另存为“DocuGen”或“电子表格”
现在，这个项目中的每一次对话都将充分了解DocuGen的能力！
💬 使用示例
创建预算跟踪器
"Create a personal budget tracker with income, expenses, and monthly summary"导入CSV数据
"Import this CSV data and analyze it:
Date,Product,Sales,Quantity
2024-01-15,Widget A,1500,50
2024-01-16,Widget B,2300,75
Create a pivot table and sales chart"构建仪表板
"Create a financial dashboard for Q4 2024 with revenue tracking, expense categories, and KPI metrics"项目管理
"Build a project tracker with task list, timeline, status tracking, and Gantt chart visualization"🧪 测试
测试服务器安装：
# Test server with dummy credentials (no authentication required)
cd docugen
GOOGLE_OAUTH_PATH="/tmp/dummy_credentials.json" python3.12 docugen_mcp_server.py --help
# For actual testing with authentication:
GOOGLE_OAUTH_PATH="/path/to/your/credentials.json" python3.12 docugen_mcp_server.py📁 项目结构
docugen/
├── docugen_mcp_server.py # Main server (3700+ lines, 62 operations)
├── requirements.txt # Python dependencies
├── LICENSE # Apache 2.0 license
├── README.md # This file
└── docs/
├── SETUP_GUIDE.md # Detailed setup instructions
├── DOCUGEN_SYSTEM_PROMPT.md # Claude's instructions
└── DOCUGEN_USER_PROMPTS.md # Example prompts🔧 运作原理
- 你告诉克劳德 你想用自然语言表达什么
- 克劳德明白了 您的业务需求
- DocuGen执行 适当的Google表格操作
- 有 无需编写代码的专业电子表格
技术细节
- 用途 FastMCP 高效实施MCP的框架
- OAuth 2.0 使用Google进行身份验证
- 令牌安全存储在
~/.docugen/token.json - 所有操作都在一个组织良好的文件中
- 全面的错误处理和验证
🚨 重要提示
- CSV导入：用户必须将数据粘贴为文本（Claude无法访问本地文件）
- 权限：第一次运行打开浏览器进行谷歌授权
- 电子表格ID：Claude在创建电子表格后提供ID
- 运营：Claude可以创建、读取、更新、格式化，但不能删除整个电子表格
🐛 故障排除
服务器未出现在Claude Desktop中
- 确保配置中的路径是绝对的，而不是相对的
- 检查Python版本：
python3.12 --version - 完全重新启动克劳德桌面
- 验证凭据文件是否存在
身份验证问题
- 确保Google Sheets API已启用
- 检查OAuth同意屏幕是否已配置
- 验证您正在使用桌面应用凭据
导入错误
# Reinstall MCP SDK
pip uninstall mcp
pip install git+https://github.com/modelcontextprotocol/python-sdk.git📚 资源
入门指南
- SETUP_GUIDE.md -带有屏幕截图的详细设置演练
- DOCUGEN_USER_PROMPTS.md -50+示例提示尝试
优化克劳德的表现
- DOCUGEN_SYSTEM_PROMPT.md -添加到Claude Desktop项目说明以获得最佳结果（包括12个详细的工作流程示例）
🤝 贡献
欢迎投稿！代码库是一个单独的文件(docugen_mcp_server.py)有62个组织良好的行动。
要添加新操作，请执行以下操作：
- 将您的功能添加到
docugen_mcp_server.py - 用…装饰
@mcp.tool() - 遵循现有的参数和返回模式
- 使用虚拟或真实凭据在服务器上进行测试
📄 许可证
Apache-2.0许可证-请参阅 许可证 文件
👨💻 作者
由高塔姆·曼德沃克创作
📍 Cumming，福赛斯县，佐治亚州，美国
🔗 | 领英
🙏 致谢
📊 状态
✅ 生产就绪
- 62个可用工具（与Claude Desktop中显示的完全相同）
- 简单的单文件架构
- FastMCP性能框架
- 全面的错误处理
- 已准备好立即与Claude Desktop一起使用