关于 DeepPane Focus Space
DeepPane Focus Space 是官方 stdio MCP 服务,用于创建专注空间并读取用户授权的专注历史摘要。它通过单独的授权交接处理账户范围操作,不提供原始专注事件或媒体目录。
主要功能
- 01创建专注空间
- 02读取专注历史摘要
- 03请求创建授权令牌
- 04请求历史摘要授权令牌
适用场景
- 01为一次专注工作创建空间
- 02查看经授权的专注历史摘要
MCP 相关
这是一个通过 stdio 接入 MCP 客户端的 MCP 服务,提供创建专注空间、读取历史摘要及发起授权交接的工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
4收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| quote | object | 否 | 引文请求。Free 使用目录中的引文;Pro handoff token 可能允许自定义引文文本。 |
| quote.mode | enum | 否 | catalog | custom |
| quote.text | string | 否 | |
| quote.title | string | 否 | |
| quote.author | string | 否 | |
| quote.intent | string | 否 | |
| quote.customText | string | 否 | |
| timer | object | 否 | 有界计时器请求。 |
| timer.preset | string | 否 | |
| timer.presetId | string | 否 | |
| timer.breakMinutes | integer | 否 | |
| timer.breakSeconds | integer | 否 | |
| timer.focusMinutes | integer | 否 | |
| timer.focusSeconds | integer | 否 | |
| timer.durationMinutes | integer | 否 | |
| intent | enum | 否 | 用于语义场景和音乐选择的受支持工作意图。ambient_work | coding | creative_reset | deep_work | focus | inspiration | planning | reading | recovery | study | travel_reset | writing |
| locale | string | 否 | 可选的 DeepPane 区域设置,例如 en 或 zh-CN。 |
| musicHints | object | 否 | 用于音乐选择的安全语义提示,不是原始曲目元数据。 |
| musicHints.use | any | 否 | |
| musicHints.mood | any | 否 | |
| musicHints.sound | any | 否 | |
| musicHints.style | any | 否 | |
| musicHints.energyLevel | any | 否 | |
| musicHints.vocalProfile | any | 否 | |
| musicHints.distractionLevel | any | 否 | |
| sceneHints | object | 否 | 用于场景选择的安全语义提示,不是原始目录筛选条件。 |
| sceneHints.mood | any | 否 | |
| sceneHints.sound | any | 否 | |
| sceneHints.motion | any | 否 | |
| sceneHints.timeOfDay | any | 否 | |
| sceneHints.brightness | any | 否 | |
| sceneHints.environment | any | 否 | |
| sceneHints.focusSafety | any | 否 | |
| sceneHints.visualDensity | any | 否 | |
| attribution | object | 否 | 可选的安全调用方归属信息。请勿包含机密、账户数据、原始提示词或个人历史记录。 |
| attribution.runId | string | 否 | |
| attribution.source | string | 否 | |
| attribution.agentRunId | string | 否 | |
| operationId | string | 否 | 稳定的 operation id;省略 idempotencyKey 时,它会与 attribution.agentRunId 组合使用。 |
| handoffToken | string | 否 | 从 DeepPane Dashboard 的 Agent Access 面板复制的短期 focus_space.create token。 |
| idempotencyKey | string | 否 | 稳定的不透明键,用于支持安全重试的创建操作。仅对同一逻辑请求重复使用。 |
详细介绍
DeepPane MCP 服务
用于创建 DeepPane 专注空间并读取用户授权的专注历史摘要的官方 stdio MCP 服务。
要求
- Node.js 20 或更高版本
- 支持本地 stdio 服务的 MCP 客户端
运行
npm exec --yes --package=@deeppane/mcp-server -- deeppane-mcp
如果已安装 npx,也可以使用更简短的等效命令 npx -y @deeppane/mcp-server。
MCP 客户端配置示例:
{
"mcpServers": {
"deeppane": {
"command": "npm",
"args": ["exec", "--yes", "--package=@deeppane/mcp-server", "--", "deeppane-mcp"]
}
}
}
在 Windows 上,如果未安装 npx,或者 MCP 客户端无法解析命令 shim,建议使用 npm 原生形式。
工具
deeppane.create_focus_space:使用匿名 Free 行为或用户授权的交接令牌,创建可安全重试的专注空间。deeppane.read_history_summary:使用用户授权的交接令牌,读取经过净化的专注历史摘要。deeppane.request_focus_space_create_token:打开用于创建专注空间的 DeepPane 授权交接流程。deeppane.request_history_summary_token:打开用于历史摘要的单独授权交接流程。
该服务不会公开 DeepPane 媒体目录、原始专注事件、存储密钥、签名媒体 URL 或用户凭据。
可选环境设置
DEEPPANE_MCP_TIMEOUT_MS:请求超时时间,范围为 1000 至 60000 毫秒。默认值:15000。
正常的公开使用无需 API 密钥。账户范围工具的授权由用户在 DeepPane Dashboard 中完成,并通过短期有效的交接令牌传递给相应的工具调用。
开发
npm install
npm test
npm run check:clean-install
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。