Streamline MCP

简化MCP

MCP服务器，允许AI助手访问您的Streamline任务、笔记、标签和工作区。

设置

1.配置凭据

创建 ~/.config/streamline-mcp/config.json:

{
  "projectURL": "https://YOUR_PROJECT_ID.supabase.co",
  "apiKey": "YOUR_SERVICE_ROLE_KEY",
  "userID": "YOUR_USER_UUID"
}

在哪里可以买到这些：

• apiKey：Supabase仪表板→ 设置→ API → service_role 钥匙
• userID：Supabase仪表板→ 认证→ 用户→ 您的用户ID

2.添加到克劳德代码

编辑 ~/.claude.json:

{
  "mcpServers": {
    "streamline": {
      "command": "npx",
      "args": ["github:YOUR_USERNAME/streamline-mcp"]
    }
  }
}

或者在本地运行：

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

3.重新启动克劳德代码

这些工具现在将可用。

______________________________________________________________________

工具

任务

备注

标签

工作区

______________________________________________________________________

例子

基本任务

# Create a task with tags and due date
create_task(name: "Review PR", due_date: "tomorrow", tags: ["work"], is_urgent: true)

# Search tasks due today
search_tasks(due_before: "today", include_completed: false)

# Complete a task
complete_task(uuid: "550e8400-e29b-41d4-a716-446655440000")

周期性任务

# Create a daily recurring task
create_recurring_task(
  name: "Morning standup",
  due_date: "tomorrow",
  frequency: "daily",
  tags: ["work"]
)

# Create a weekly task on specific days
create_recurring_task(
  name: "Gym workout",
  due_date: "2025-02-15",
  frequency: "weekly",
  interval: 1,
  weekdays: [2, 4, 6],  # Mon, Wed, Fri (1=Sun, 7=Sat)
  tags: ["health"]
)

# Create a monthly task
create_recurring_task(
  name: "Pay rent",
  due_date: "2025-03-01",
  frequency: "monthly",
  day_of_month: 1,
  tags: ["bills"]
)

# Complete a recurring task (auto-creates next occurrence)
complete_task(uuid: "recurring-occurrence-uuid")

# Skip without completing
skip_recurring_task(uuid: "recurring-occurrence-uuid")

# Pause the series (no new occurrences until resumed)
pause_recurring_series(uuid: "any-task-in-series")

# Resume a paused series
resume_recurring_series(uuid: "any-task-in-series")

# End the series permanently
end_recurring_series(uuid: "any-task-in-series")

工作区筛选

# Search tasks in a specific workspace
search_tasks(workspace: "Work", due_before: "today")

# Search notes in a workspace
search_notes(workspace: "Projects", query: "meeting notes", limit: 10)

# List workspaces with their filtering rules
list_workspaces(include_rules: true)

# Get workspace details by name
read_workspace(name: "Work")

备注

# Append to a note
update_note(uuid: "...", append: "\n\n## Follow-up\nNew content here")

______________________________________________________________________

重复任务-工作原理

Streamline中的重复任务使用模板/事件模型：

1. 模板：存储重复规则的隐藏“主”任务
2. 发生次数：与您交互的可见任务

当您完成或跳过重复任务时：

• 事件标记为完成/跳过
• 下一个事件将根据规则自动创建

重复选项

锚点类型

• 预定截止日期 （默认）：下一个任务是相对于它的时间安排的 *应该* 有待完成。适用于“每周一”这样的固定时间表。

• 完工日期：下一个任务是相对于您的时间安排的 *实际上* 已完成。适用于“换油后2周”等任务。

______________________________________________________________________

环境变量

您可以使用环境变量而不是配置文件：

SUPABASE_URL=https://YOUR_PROJECT_ID.supabase.co
SUPABASE_API_KEY=your_service_role_key
SUPABASE_USER_ID=your_user_uuid

______________________________________________________________________

发展

npm install
npm run build
npm start

更新日志

v1.1.0版本

• 添加了完整的重复任务支持：

- create_recurring_task -创建具有重复规则的任务 - skip_recurring_task -跳过事件 - pause_recurring_series / resume_recurring_series -控制系列 - end_recurring_series -永久结束系列 - complete_task 现在自动为重复任务创建下一个事件

• 添加 include_recurring_templates 选择权 search_tasks
• read_task 现在显示重复详细信息

v1.0.0

• 包含任务、笔记、标签和工作区的初始版本