关于 Sparks
Sparks 是一个供 MCP 客户端连接的创意笔记本,面向需要借助 Agent 查找、记录和整理笔记、项目及子任务的人。它提供远程服务和 OAuth 登录,并刻意不提供删除工具。
主要功能
- 01搜索和筛选笔记
- 02查看项目及笔记详情
- 03创建和更新笔记
- 04添加子任务并标记完成
- 05将笔记归入项目
- 06配置 Send-to-agent webhook
适用场景
- 01让 Agent 查找相关笔记
- 02将新想法记录到收件箱或项目
- 03将笔记拆分为多层子任务
- 04检查或设置 Agent webhook 连接状态
MCP 相关
远程 MCP 服务通过 Streamable HTTP 提供笔记本工具,使用 OAuth 2.1 和 PKCE 登录,并支持动态客户端注册。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://sparks.6x7.gr/api/mcpclaude mcp add --transport http gr-6x7-sparks https://sparks.6x7.gr/api/mcp{"mcpServers":{"gr-6x7-sparks":{"type":"http","url":"https://sparks.6x7.gr/api/mcp"}}}在 Cursor 中打开{"servers":{"gr-6x7-sparks":{"type":"http","url":"https://sparks.6x7.gr/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"gr-6x7-sparks":{"type":"http","url":"https://sparks.6x7.gr/api/mcp"}}}{"mcpServers":{"gr-6x7-sparks":{"serverUrl":"https://sparks.6x7.gr/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Sparks MCP
将任意 MCP 客户端(Cursor、Claude、Claude Code、Codex、OpenClaw、Grok Bot 等)连接到你的 Sparks 灵感笔记本。你的 Agent 可以查找、记录并整理笔记、 项目和子任务。我们特意不提供删除工具。
- 服务:
https://sparks.6x7.gr/api/mcp(Streamable HTTP,远程,无需安装) - 登录: 使用 PKCE 和动态客户端注册的 OAuth 2.1。添加 URL,并在 Sparks 中批准一次。不支持 OAuth 的 Agent 可使用
skills/connect-to-sparks中的一键连接链接。
安装
Cursor: 从 Marketplace 安装 sparks 插件,或添加到 mcp.json:
{ "mcpServers": { "sparks": { "url": "https://sparks.6x7.gr/api/mcp" } } }
Claude Code: 运行 claude mcp add --transport http sparks https://sparks.6x7.gr/api/mcp,然后选择 /mcp → Authenticate。
Codex: 添加 [mcp_servers.sparks],并设置 url = "https://sparks.6x7.gr/api/mcp",然后运行 codex mcp login sparks。
更多信息:https://sparks.6x7.gr/help/connect-agent
工具
| 工具 | 功能 | 注解 |
|---|---|---|
list_projects | 列出你的项目及笔记数量 | 只读 |
list_notes | 搜索/筛选笔记 | 只读 |
get_note | 获取一条笔记、所属项目及完整子任务树 | 只读 |
create_note | 创建笔记(收件箱或项目) | 写入,不具破坏性 |
update_note | 修改标题、正文、标签、完成状态、置顶状态、截止日期或项目 | 写入,幂等 |
add_subtask | 添加子任务(最多 4 层) | 写入,不具破坏性 |
mark_done | 将笔记或子任务标记为已完成/未完成 | 写入,幂等 |
add_note_to_project | 也将笔记归入某个项目 | 写入,幂等 |
get_agent_connection_status | 检查是否已设置“发送给 Agent” Webhook | 只读 |
set_agent_webhook | 注册 Sparks 在“发送给 Agent”时调用的 Webhook | 写入,幂等 |
内容
.cursor-plugin/plugin.json:Cursor 插件清单mcp.json:远程 MCP 服务配置skills/connect-to-sparks/:Agent 设置技能server.json:MCP Registry 条目(gr.6x7/sparks)
隐私、条款与支持
许可证:MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。