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内容同步到SparkSheetslog_work_time-记录工作时间get_usage_dashboard-获取使用面板URL
任务管理(2工具)
sync_todos-将TodoWrite内容同步到SparkSheetsget_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 代码命令行工具
- 图纸规格说明书→自动安装
- 任务栏-自动运行
- 错误报告-自动修复
一边使用一边随时追加必要的功能。
📄 许可证
麻省理工学院
🤝 分发
Issue PR 的下界。
