Oscribble MCP Server

Oscribble MCP 服务器

模型上下文协议（MCP）服务器用于 Oscribble（这个词汇在常规中文语境下并不常见，可能是某个特定品牌、项目或概念的名称，直接翻译可能无法准确传达其含义，但按字面可尝试翻译为）：O scribble（O字加涂鸦，意指以O字为基础进行的涂鸦或创意书写） - 使Claude Code能够通过自然语言与您的Oscribble任务项目进行交互。

这是什么？

这个MCP服务器将您的Oscribble任务暴露给Claude Code，使您能够：

• 列出并筛选跨项目的任务
• 完成或未完成的任务
• 查看详细的任务元数据（优先级、阻塞项、备注）
• 向项目中添加新任务
• 查询任务状态和依赖项

在Claude Code中，全程采用自然语言对话。

安装

快速入门（推荐）

将此添加到您的Claude Code MCP配置中（~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "oscribble": {
      "command": "npx",
      "args": ["-y", "@oscargavin/oscribble-mcp"]
    }
  }
}

重启Claude代码后，MCP服务器将可用。

手动安装

npm install -g @oscargavin/oscribble-mcp

然后配置Claude Code以使用已安装的二进制文件：

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

可用工具

oscribble_list_projects

列出所有Oscribble项目，包括路径和最后访问时间戳。

示例： “显示我所有的Oscribble项目”

oscribble_list_tasks

列出项目中的任务，并可选择性地进行状态过滤。

参数：

• project_name (字符串，必填) - 项目名称
• filter_status （字符串，可选）- 通过……进行过滤 "all"， "checked"，或者 "unchecked" （默认： "all"）

示例：

• “列出我工作项目中的所有任务”
• “在oscribble中显示未完成的任务”
• “在my-project中有哪些任务尚未完成？”

oscribble_complete_task

将任务标记为已完成。

参数：

• project_name （字符串，必填）- 项目名称
• task_id （字符串，必填）- 任务的 UUID

示例： “在我的工作项目中完成任务abc-123”

oscribble_uncomplete_task

将任务标记为未完成。

参数：

• project_name (字符串，必填) - 项目名称
• task_id （字符串，必填）- 任务的UUID

示例： “工作项目中的未完成任务 abc-123”

oscribble_get_task_details

获取特定任务的详细信息，包括元数据、备注和阻碍因素。

参数：

• project_name (字符串，必填) - 项目名称
• task_id (字符串，必填) - 任务的UUID

示例： “在oscribble中显示任务abc-123的详细信息”

oscribble_add_raw_task

将原始任务文本添加到项目中。任务将在下次同步时由Oscribble进行格式化。

参数：

• project_name （字符串，必填）- 项目名称
• task_text （字符串，必填）- 要追加的原始任务文本

示例： “将‘实现深色模式’添加到我的工作项目中”

使用示例

以下是一些自然语言查询，一旦MCP服务器配置完成，您就可以在Claude Code中使用它们：

"What tasks are blocked in oscribble?"
"Show me all critical priority tasks"
"List unchecked tasks across all projects"
"Complete the task about implementing dark mode"
"Add a new task to fix the login bug in my-app"
"What's the status of task abc-123?"

它是如何运作的

MCP服务器与Oscribble桌面应用程序读写至相同的存储位置~/.project-stickies/），使用：

• 原子写入 - 临时文件 + 重命名模式可防止数据损坏
• 安全的并发访问 - 在Oscribble应用程序打开时，读取操作可以正常进行
• 相同的数据结构 - 使用与主应用相同的TypeScript类型

存储结构

~/.project-stickies/
├── settings.json         # App-wide settings
├── projects.json         # Project registry
└── {project-name}/
    ├── notes.json        # Structured tasks (read/write)
    ├── raw.txt           # Raw input (write for new tasks)
    └── .context-cache/   # (Future use)

发展

从源代码构建

git clone https://github.com/oscargavin/oscribble-mcp.git
cd oscribble-mcp
npm install
npm run build

项目结构

src/
├── index.ts       # Main MCP server implementation
├── types.ts       # TypeScript type definitions
└── utils.ts       # Utility functions (file I/O, task operations)

本地测试

构建完成后，您可以通过更新Claude Code配置以指向构建好的文件，从而在本地测试服务器：

{
  "mcpServers": {
    "oscribble": {
      "command": "node",
      "args": ["/path/to/oscribble-mcp/build/index.js"]
    }
  }
}

故障排除

“未找到项目”

确保你首先在Oscribble桌面应用程序中创建了至少一个项目。MCP服务器会从那里读取数据 ~/.project-stickies/projects.json。

“项目未找到”

项目名称区分大小写。请使用 oscribble_list_projects 查看可用的确切项目名称。

“笔记文件不存在”

这个项目尚未进行格式化。请在Oscribble桌面应用程序中打开该项目，并先对一些任务进行格式化。

MCP服务器未在Claude代码中显示

1. 检查你的 ~/.claude/claude_desktop_config.json 语法是有效的JSON
2. 完全重启Claude代码（退出并重新打开）
3. 查看Claude代码日志于 ~/Library/Logs/Claude/mcp.log (macOS)

要求

• Node.js 18+（用于npx安装）
• Oscribble 桌面应用程序 - 这个MCP服务器是主应用程序的配套工具

许可证

MIT 许可证 - 请参阅 许可证 详情请见。

做出贡献

欢迎提交问题和拉取请求至 。

相关的

• Oscribble 桌面应用程序 - 主任务管理器应用程序
• 模型上下文协议 - 了解更多关于MCP的信息
• 克劳德·科德 - 基于人工智能的代码助手