内容
# SparkSheets MCP 服务器
SparkSheets 的 MCP 服务器 - 用于 Claude Code、Cursor 和 Cline 的 AI 驱动文档平台集成。
[日本語](#-概要) | 中文
## 安装
```bash
npm install -g @sparksheets/mcp
```
## 快速设置
将以下内容添加到您的 `~/.claude.json` 文件中：
```json
{
"mcpServers": {
"sparksheets": {
"command": "sparksheets-mcp"
}
}
}
```
然后使用您的 SparkSheets 账户登录：
```
sparksheets_login
```
## 功能
- **会话管理** - 保存和搜索开发会话历史
- **知识库** - 存储错误解决方案和代码片段
- **使用情况跟踪** - 同步 /stats 输出和工作时间
- **表格操作** - 从 CLI 创建、编辑、搜索表格
- **Spark 集成** - 从终端运行 AI 功能
## 可用工具（37 个工具）
| 类别 | 工具 |
|----------|-------|
| 认证 | `sparksheets_login`, `sparksheets_logout`, `sparksheets_auth_status` |
| 会话管理 | `save_session`, `list_sessions`, `search_sessions`, `create_handover` |
| 知识库 | `save_solution`, `find_solution`, `save_snippet`, `get_snippet` |
| 表格操作 | `upload_image`, `append_to_sheet`, `list_sheets`, `create_sheet`, `update_sheet`, `get_sheet_content`, `search_sheets`, `delete_sheet`, `add_column`, `remove_column`, `get_column_info` |
| 统计 | `sync_stats`, `log_work_time`, `get_usage_dashboard` |
| 任务管理 | `sync_todos`, `get_review_queue` |
| Spark 集成 | `run_spark`, `list_sparks`, `translate_sheet` |
| 共享和成员管理 | `create_share_link`, `get_share_settings`, `disable_share`, `list_members`, `add_member`, `update_member_role`, `remove_member` |
## 文档
- 用户指南：https://sparksheets.ai/docs/guide/mcp/
- SparkSheets：https://sparksheets.ai/
## 许可证
MIT
---
# 日本語ドキュメント
Claude Code开发者的dashboard。会话历史、知识库、使用量统计、任务管理在SparkSheets中一站式管理。
## 📋 概要
本 MCP 服务器集成 Claude Code 和 SparkSheets，实现以下功能：
- **会话管理**：开发会话历史保存与搜索
- **知识库**：错误解决方案与代码片段的积累
- **使用量跟踪**：/stats 输出的自动保存与可视化
- **任务管理**：TodoWrite 的进度同步
- **表格操作**：SparkSheets 的 CRUD 操作
- **Spark 連携**：AI 按钮功能的 CLI 执行
## 🛠️ 安装
### npm（推荐）
```bash
npm install -g @sparksheets/mcp
```
将以下内容添加到 `~/.claude.json`：
```json
{
"mcpServers": {
"sparksheets": {
"command": "sparksheets-mcp"
}
}
}
```
### 手动安装
```bash
git clone https://github.com/sparksheets/mcp.git ~/.claude/mcp-servers/mcp-sparksheets
cd ~/.claude/mcp-servers/mcp-sparksheets
npm install
```
将以下内容添加到 `~/.claude.json`：
```json
{
"mcpServers": {
"sparksheets": {
"type": "stdio",
"command": "node",
"args": ["/Users/YOUR_USERNAME/.claude/mcp-servers/mcp-sparksheets/server.js"]
}
}
}
```
## 🔧 初次认证
在 Claude Code 中执行：
```
sparksheets_login
```
或自然语言：
```
「SparkSheetsにログインして」
```
浏览器将打开，使用 Google 账户认证后，自动保存令牌。
**令牌保存位置**：`~/.sparksheets/tokens.json`
## 🛠️ 实现工具列表（37 个工具）
### 认证（3 个工具）
- `sparksheets_login` - 登录 SparkSheets。浏览器将打开，使用 Google 账户认证后，自动保存令牌。
- `sparksheets_logout` - 从 SparkSheets 注销。删除已保存的令牌。
- `sparksheets_auth_status` - 检查当前认证状态。显示登录用户信息和令牌有效期。
### 会话管理（4 个工具）
- `save_session` - 将当前会话摘要保存到 SparkSheets
- `list_sessions` - 获取所有会话列表
- `search_sessions` - 按关键词搜索会话
- `create_handover` - 自动生成交接表（总结下一步工作、注意事项等）
### 知识库（4 个工具）
- `save_solution` - 将错误解决方案保存到词典中
- `find_solution` - 搜索过去的解决方案
- `save_snippet` - 保存代码片段
- `get_snippet` - 获取/搜索片段
### 表格操作（11 个工具）
- `upload_image` - 将图像上传到 SparkSheets。指定 Base64 或文件路径。返回值包含 Markdown 格式的图像标签
- `append_to_sheet` - 在表格的指定列末尾追加内容
- `list_sheets` - 获取表格列表
- `create_sheet` - 创建新表格
- `update_sheet` - 编辑表格
- `get_sheet_content` - 获取表格内容（选项中可控制上下文）
- `search_sheets` - 搜索表格
- `delete_sheet` - 删除表格
- `add_column` - 在表格中添加列（最多 3 列）
- `remove_column` - 从表格中删除列
- `get_column_info` - 获取表格的列信息
### 统计/工作时间（3 个工具）
- `sync_stats` - 将 /stats 内容同步到 SparkSheets
- `log_work_time` - 记录工作时间
- `get_usage_dashboard` - 获取使用量仪表盘 URL
### 任务管理（2 个工具）
- `sync_todos` - 将 TodoWrite 内容同步到 SparkSheets
- `get_review_queue` - 获取 PR 审查队列（GitHub 集成）
### Spark 集成（3 个工具）
- `run_spark` - 从 CLI 执行 Spark（AI 按钮）
- `list_sparks` - 获取可用 Spark 列表
- `translate_sheet` - 将表格进行多语言翻译
### 共享/成员管理（7 个工具）
- `create_share_link` - 发出表格的共享链接。如果已有活跃共享，则重复使用
- `get_share_settings` - 获取表格的当前共享设置
- `disable_share` - 禁用共享链接
- `list_members` - 获取表格的成员列表
- `add_member` - 将成员添加到表格（邀请）。仅所有者可执行
- `update_member_role` - 更改成员权限。仅所有者可执行
- `remove_member` - 从表格中删除成员。仅所有者可执行
## 📝 使用示例
### 会话保存
```
「今日の作业をSparkSheetsに保存して」
→ save_session 工具将被执行
→ https://sparksheets.ai/sheet/xxx 保存
```
### 错误词典
```
「このCORSエラーの解決策、保存しておいて」
→ save_solution 工具将被执行
「CORSエラーの直し方、前に保存したやつ見せて」
→ find_solution("CORS") 搜索
```
### 交接表
```
「引き継ぎシート作って」
→ create_handover 工具将被执行
→ 生成下一步工作、注意事项、相关文件汇总的表格
```
### 统计同步
```
「/statsの结果をSparkSheetsに保存して」
→ sync_stats 工具将被执行
→ 可视化图表的仪表盘
```
## 🗂️ 文件构成
```
~/.claude/mcp-servers/mcp-sparksheets/
├── server.js # MCP 服务器本体
├── package.json
├── README.md # 本文件
├── tools/
│ ├── auth.js # 认证工具
│ ├── sessions.js # 会话管理工具
│ ├── knowledge.js # 知识库工具
│ ├── stats.js # 统计工具
│ ├── tasks.js # 任务管理工具
│ ├── sheets.js # 表格操作工具
│ └── spark.js # Spark 集成工具
├── lib/
│ ├── api-client.js # SparkSheets API 包装器
│ └── storage.js # 本地 JSON 保存
└── logs/
├── sessions.json # 会话历史
├── solutions.json # 错误词典
├── snippets.json # 片段
├── stats-history.json # 统计历史
└── work-time.json # 工作时间日志
```
## 🔄 数据存储策略
**双重存储**：
- **本地**：`logs/*.json` 以 JSON 格式保存（离线支持）
- **云端**：SparkSheets 以表格形式保存（共享与可视化）
## 🚀 未来扩展计划
### SparkSheets → Claude Code CLI
- 表格规格说明书 → 自动实现
- 任务面板 → 自动执行
- 错误报告 → 自动修复
边使用边根据需求添加新功能。
## 📄 许可证
MIT
## 🤝 贡献
Issue 和 PR 请至 [GitHub 仓库](https://github.com/sparksheets/mcp)。
