Ziggy MCP

MCP运维云端

提供方 PromptishOperations · 包名 playwright

运维云端 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaude
查看接入方式

Ziggy MCP是一个连接Claude AI和Google Sheets的模型上下文协议服务器,用于自动化收入跟踪、潜在客户管理和业务运营。

一句话选型结论

按资料字段整理

Ziggy MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI集成JavaScript本地部署自动化业务管理GoogleSheets集成潜在客户跟踪收入分析

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx playwright install chromium

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Ziggy MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方PromptishOperations上游标注的维护方 PromptishOperations
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时playwright · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.4 KB
来自项目仓库与上游目录的原文,未做删改

一个模型上下文协议(MCP)服务器,用于将Claude AI与Google Sheets连接,以实现收入追踪、潜在客户管理及业务运营的自动化。

特点/功能

  • 📊 表格、数据图表 仪表盘实时收入指标和关键绩效指标(KPIs)
  • 🎯(目标/瞄准) 潜在客户线索(或销售漏斗中的潜在客户)从首次接触开始追踪潜在客户直至成交
  • 📧(电子邮件) Gmail 集成搜索电子邮件并自动化外展联系
  • 📅 日期/日历 日历同步跟踪会议及后续跟进情况
  • 📝(一个带有笔的图标,通常用于表示笔记或书写) 知识矩阵带时间戳跟踪的开发日志
  • ✅ 任务管理优先处理并跟踪项目任务
  • 📈 表示“上升趋势”或“增长”。 分析(或分析学)每日指标和性能跟踪

先决条件

  • Node.js 18.0.0或更高版本
  • Google 账户 提供Sheets和Gmail访问权限
  • Claude Desktop(可译为“Claude桌面版”或根据具体语境简化为“Claude桌面”) 或兼容的MCP客户端
  • Google Apps 脚本 (对于后端API)
  • 剧作家 (用于浏览器自动化)

安装

1. 克隆仓库```bash

git clone https://github.com/yourusername/ziggy-mcp.git
cd ziggy-mcp


### 2. 安装依赖项```bash
npm run setup
# This installs Node packages AND Playwright browsers

手动替代方案:```bash
npm install
npx playwright install chromium


### 3. 设置Google Sheets后端

1. 创建一个新 Google 表格
1. 首选 **扩展 > Apps Script**
1. 删除所有现有代码
1. 复制所有文件自 `/apps-script` 目录:
- `Code.js` - 表格设置脚本
- `API.js` 主API处理程序
- `calendarSync.js` - 日历集成
- `appsscript.json` - 表现;展示
1. 点击 **保存** (磁盘图标)
1. 点击 **运行 > 设置收入引擎**
1. 当提示时授权脚本
1. 等待30-60秒以完成
1. 作为网络应用部署:
- 点击 **部署 > 新部署**
- 类型: **网页应用**
- 执行方式为: **我**
- 谁可以访问: **任何人**
- 点击 **部署**
- 复制 **网页应用URL**

### 4. 配置MCP服务器

编辑 `index.js` 并更新API URL:```javascript
const API_URL = "YOUR_GOOGLE_APPS_SCRIPT_WEB_APP_URL";

5. 连接到Claude桌面版

添加到您的Claude桌面配置中(~/Library/Application Support/Claude/claude_desktop_config.json (在 macOS 上):```json
{
"mcpServers": {
"ziggy": {
"command": "node",
"args": ["/absolute/path/to/ziggy-mcp/index.js"]
}
}
}


替换 `/absolute/path/to/ziggy-mcp/` 使用您实际的安装路径。

### 6. 重启Claude桌面应用

退出并重新打开 Claude Desktop 以加载 MCP 服务器。

______________________________________________________________________

## 浏览器自动化设置

### 设置认证会话

对于Upwork、LinkedIn及其他平台:

**步骤1:以可见模式打开浏览器**```
Open Upwork in browser with visible mode

步骤2:我将打开一个浏览器窗口 - 您手动登录

步骤3:保存会话```
Save browser session as "upwork"


**步骤4:进行测试**```
Browse upwork.com using saved session

支持的平台

  • ✅ 表示“正确”或“完成”。 Upwork(一个在线自由职业者和外包工作平台) - 搜寻工作,提交提案
  • ✅ 领英 - 个人资料研究,发送连接请求
  • ✅ 任何网站 - 自定义抓取与自动化

安全注意事项

  • 会话数据本地存储在 sessions/ 文件夹
  • 永不 将会话文件提交到 Git 中
  • 会话中包含您的身份验证令牌
  • 大约30天后过期
  • 在需要时重新进行身份验证

使用方法

基本命令

获取仪表盘:```
Show me my revenue dashboard


**查看管道:**```
What leads are in my pipeline?

添加一个潜在客户:```
Add a new lead: Acme Corp, contact John Smith, email john@acme.com


**检查Gmail:**```
Search my unread emails

日志开发工作:```
Log to knowledge matrix: Fixed authentication bug in Gmail integration [45m]


### 知识矩阵

知识矩阵是一个结构化的开发日志,用于追踪:

- 🧪 表示“实验器材”或“实验”的意思。 **测试结果** - 测试结果
- 🎯(目标) **决策与方向** - 战略选择
- 📚 书籍或学习资料的符号 **文档更新** - 文档更改

**撰写条目:**```
Write matrix entry for Bugs & Fixes: "3:45pm EST 🐛[BUG-001] Fixed Gmail auth timeout [30m]"

查询矩阵:```
Search matrix for "authentication"


**每日总结:**```
Generate matrix summary for today

浏览器自动化

截图```
Take a screenshot of competitor-site.com


**提取数据:**```
Extract pricing from acme.com/pricing

填写表格:```
Fill the contact form at example.com with lead data for John Doe


**研究:**```
Browse to linkedin.com/company/acme and extract company info

自动化外展 (会话设置后):```
Search Upwork for "web automation" jobs and show top 5


______________________________________________________________________

## 项目结构```
ziggy-mcp/
├── index.js                 # Main MCP server
├── package.json            # Node dependencies
├── browser/                # Browser automation
│   ├── playwright.js      # Core browser functions
│   ├── upwork.js          # Upwork automation
│   └── linkedin.js        # LinkedIn automation
├── apps-script/            # Google Apps Script files
│   ├── Code.js            # Sheet setup
│   ├── API.js             # API endpoints
│   ├── calendarSync.js    # Calendar integration
│   └── appsscript.json    # Manifest
├── sessions/               # Saved browser sessions (gitignored)
├── screenshots/            # Captured screenshots (gitignored)
├── docs/                   # Documentation
│   ├── MATRIX.md          # Knowledge Matrix guide
│   ├── BUG-TRACKING.md    # Bug tracking system
│   └── BROWSER-GUIDE.md   # Browser automation guide
└── README.md              # This file

安全与隐私

  • 所有数据均存储在 你的 Google 表格
  • 通过Google Apps Script进行身份验证的API调用
  • 不使用外部数据库或第三方服务
  • 文件系统访问仅限于项目目录
  • Gmail 只读访问权限(发送需明确批准)

故障排除

MCP服务器无法连接

  1. 检查Claude Desktop的配置路径是否正确
  2. 验证 Node.js 版本: node --version (应为 ≥18.0.0)
  3. 检查控制台: Cmd+Shift+I 在Claude Desktop中
  4. 验证API_URL是否已正确设置 index.js

Google Apps Script 问题

  1. 确保脚本以Web应用的形式部署
  2. 检查执行权限(应为“任何人”)
  3. 如需重新授权:运行 > setupRevenueEngine
  4. 检查 Apps Script 日志:查看 > 日志

Gmail 集成

  1. 确保在Apps Script中已启用Gmail API
  2. 检查OAuth作用域 appsscript.json
  3. 如果权限发生更改,请重新授权

发展

本地运行```bash

node index.js


### 管理 Apps Script

安装用于本地 Apps Script 开发的夹子(或:安装本地 Apps Script 开发环境):```bash
npm install -g @google/clasp
clasp login
clasp pull  # Download from Google
clasp push  # Upload to Google

调试

启用调试日志记录 index.js:javascript const DEBUG = true;

写入日志至 debug.log 在项目目录中。

路线图

  • [ ] 添加Slack集成
  • [ ] 将报告导出为PDF格式
  • [ ] 基于人工智能的潜在客户评分
  • [ ] 自动化后续提醒
  • [ ] 发票生成
  • [ ] 团队协作功能

做出贡献

  1. 为仓库创建分支(或“克隆仓库”)
  2. 创建一个特性分支: git checkout -b feature/amazing-feature
  3. 提交更改: git commit -m 'Add amazing feature'
  4. 推送至分支: git push origin feature/amazing-feature
  5. 提交拉取请求(或合并请求)

许可证

MIT 许可证 - 详情请参见 LICENSE 文件

支持

  • 📧 电子邮件:support@example.com
  • 💬 问题: GitHub Issues(GitHub问题)
  • 📖 文档: 维基

致谢

  • 构建于 模型上下文协议
  • 通过Apps Script集成Google Sheets

专为自由职业者和小团队打造,倾注爱心之作

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Ziggy MCP 怎么安装?

在客户端按下面的安装命令接入:npx playwright install chromium。对应的包名是 playwright。装完在客户端配置里引用同一个包或端点。

Ziggy MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Ziggy MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Ziggy MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Ziggy MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Ziggy MCP 能提供哪些能力?

资料显示能力标签包括 JavaScript、Claude、云端部署。具体工具清单以官方文档为准。

Ziggy MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Ziggy MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。