使用说明

SparkSheets MCP服务器

SparkSheets的MCP服务器-用于Claude Code、Cursor和Cline的AI驱动文档平台集成。

安装

npm install -g @sparksheets/mcp

快速设置

添加到您的 ~/.claude.json:

{
  "mcpServers": {
    "sparksheets": {
      "command": "sparksheets-mcp"
    }
  }
}

然后使用您的SparkSheets帐户登录：

sparksheets_login

特性

会话管理 -保存和搜索开发会话历史记录
知识库 -存储错误解决方案和代码片段
使用情况跟踪 -同步/统计输出和工作时间
工作表操作 -从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/
火花板：https://sparksheets.ai/

许可证

麻省理工学院

日语文档

用于云代码开发人员的仪表板。通过SparkSheets集中管理会话历史记录、知识库、使用统计信息和任务管理。

📋 概要

此MCP服务器集成了Claude Code和SparkSheets，可：

会话管理：保存和搜索开发会话
知识库：错误解决方案和代码片段积累
使用量追迹：/stats出力の自动保存・可视化
任务管理：TodoWrite进度同步
工作表操作: SparkSheets CRUD操作
Spark连携：运行AI按钮功能CLI

🛠️ 安装

npm（推奨）

npm install -g @sparksheets/mcp

~/.claude.json 添加到：

{
  "mcpServers": {
    "sparksheets": {
      "command": "sparksheets-mcp"
    }
  }
}

手动安装

git clone https://github.com/sparksheets/mcp.git ~/.claude/mcp-servers/mcp-sparksheets
cd ~/.claude/mcp-servers/mcp-sparksheets
npm install

~/.claude.json 添加到：

{
  "mcpServers": {
    "sparksheets": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/.claude/mcp-servers/mcp-sparksheets/server.js"]
    }
  }
}

🔧 初回认证

在Claude Code中：

sparksheets_login

或自然语言：

「SparkSheetsにログインして」

浏览器打开，通过谷歌账户认证后，自动保存令牌。

标记保存位置: ~/.sparksheets/tokens.json

🛠️ 安装工具列表（37工具）

认证（3工具）

sparksheets_login -登录SparkSheets。浏览器打开，通过谷歌账户认证后，自动保存令牌。
sparksheets_logout -从SparkSheets注销。删除保存的标记。
sparksheets_auth_status -验证当前身份验证状态。显示登录中的用户信息和令牌的到期日。

会话管理（4工具）

save_session -将当前会话摘要保存到空间表
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运行AI按钮
list_sparks -可用空间列表
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 将条目添加到文档注册表
云：作为工作表保存在SparkSeets中（共享/可视化）

🚀 未来扩展计划

火花板→ Claude 代码命令行工具

图纸规格说明书→自动安装
任务栏-自动运行
错误报告-自动修复

一边使用一边随时追加必要的功能。

📄 许可证