Draftsapp MCP

起草应用程序MCP服务器

用于集成的模型上下文协议（MCP）服务器 草稿应用程序 通过AI助手 苹果快捷方式.

为什么选择快捷方式？

此服务器使用Apple Shortcuts而不是x-callback-url，因为快捷方式可以：

• ✅ 列出所有草稿 （不仅仅是个人）
• ✅ 搜索和筛选 具有复杂查询的草稿
• ✅ 返回结构化JSON 数据直接
• ✅ 访问所有草稿属性 （标签、日期、内容等）
• ✅ 无需回调服务器 -直接、同步响应
• ✅ 更强大、更灵活 比URL方案

需求

• macOS 12（蒙特利）或更高版本 （为 shortcuts CLI）
• Node.js 18或更高版本
• 草稿应用程序 （macOS版本）
• 快捷方式应用程序 （预装在macOS上）
• MCP兼容客户端（例如Claude Desktop）

检查您的节点版本

node --version

如果您使用的是旧版本，请使用nvm进行升级：

nvm install 20
nvm use 20
nvm alias default 20

安装

1.安装MCP服务器

git clone 
cd draftsapp-mcp
npm install
npm run build

2.设置快捷方式（交互式助手可用！）

这是关键的一步！ 您需要创建MCP服务器将调用的快捷方式。

🚀 快速设置（推荐）：

npm run setup

此交互式脚本将：

• ✓ 检查您已经拥有哪些快捷方式
• ✓ 显示需要创建哪些
• ✓ 为每个人提供快速说明
• ✓ 为您打开快捷方式应用程序
• ✓ 生成模板文件以供参考

手动设置：

看 短裤_设置.md 查看详细的视觉说明。

必需的快捷方式 （在Shortcuts应用程序中创建这5个）：

1. “草稿-全部获得” -以JSON格式返回草稿列表
2. “草稿-搜索” -按查询搜索草稿
3. “草稿-按UUID获取” -按UUID获取特定草稿
4. “草稿-获取最新版本” -获取当前活动草稿
5. “草稿-创建” -创建新草稿

每个快捷方式都很简单（3-5个操作），并使用Drafts内置的快捷方式操作。

模板文件：

npm run setup
# Check shortcuts/ directory for .txt templates with step-by-step instructions

3.测试快捷方式

在与MCP服务器一起使用之前，请测试您的快捷方式是否有效：

# List your shortcuts
shortcuts list | grep "Drafts -"

# Test getting all drafts
shortcuts run "Drafts - Get All"

# Test search
shortcuts run "Drafts - Search" -i "meeting"

如果这些工作正常，您就可以使用MCP服务器了！

配置

适用于克劳德桌面

添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json:

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

对于特定的节点版本：

{
  "mcpServers": {
    "drafts": {
      "command": "/Users/yourusername/.nvm/versions/node/v20.x.x/bin/node",
      "args": ["/path/to/draftsapp-mcp/build/index.js"]
    }
  }
}

使用以下命令查找节点路径： which node

可用工具

drafts_list

列出草稿应用程序中的草稿。

参数：

• limit （可选）：要返回的最大草稿数（默认值：20）

例子：

List my 10 most recent drafts

退货：

[
  {
    "uuid": "ABC-123",
    "content": "Meeting notes...",
    "tags": ["work", "meeting"],
    "created": "2025-01-15",
    "modified": "2025-01-15"
  },
  ...
]

drafts_search

搜索与查询匹配的草稿。

参数：

• query （必填）：搜索查询字符串

例子：

Search my drafts for "project ideas"

drafts_get

按UUID检索特定草稿。

参数：

• uuid （必填）：草稿的UUID

例子：

Get draft with UUID ABC-123

drafts_get_current

获取草稿中当前活动/打开的草稿。

例子：

What's my current draft in Drafts?

drafts_create

创建新草稿。

参数：

• text （必填）：草案内容
• tags （可选）：标签数组

例子：

Create a draft with "Buy milk" tagged as "shopping"

退货：

{
  "uuid": "NEW-UUID",
  "success": true
}

drafts_run_shortcut

按名称运行任何与草稿相关的自定义快捷方式。

参数：

• name （必填）：快捷方式的名称
• input （可选）：输入以传递到快捷方式

例子：

Run my custom shortcut "Drafts - Export Weekly Notes"

用法示例

使用Claude Desktop设置后：

“显示我最近的5个草稿”

• 呼叫 drafts_list 限制：5
• 返回草稿的JSON数组

“在我的草稿中搜索待办事项”

• 呼叫 drafts_search 使用查询：“todos”
• 返回匹配的草稿

“我目前在草稿中做什么？”

• 呼叫 drafts_get_current
• 返回活动草稿

“起草一份草稿，上面写着‘明天打电话给牙医’”

• 呼叫 drafts_create 带文本
• 返回新草稿的UUID

运作原理

You → Claude Desktop → MCP Server → shortcuts CLI → Drafts App
                                         ↓
                     JSON data ← ← ← ← ←

1. 你让克劳德与塔夫茨互动
2. Claude称之为MCP工具
3. MCP服务器运行快捷方式命令： shortcuts run "Drafts - Get All"
4. 快捷方式在草稿应用程序中执行操作
5. 快捷方式返回JSON数据
6. MCP服务器将数据返回给Claude
7. 克劳德向您介绍信息

没有回调，没有web服务器，没有复杂性——只需要直接执行命令！

故障排除

“未找到快捷方式”

确保您已在“快捷方式”应用程序中创建了所需的快捷方式。名称必须完全匹配（区分大小写）：

• “草稿-全部获得”
• “草稿-搜索”
• “草稿-按UUID获取”
• “草稿-获取最新版本”
• “草稿-创建”

“快捷方式：找不到命令”

您使用的是macOS 11或更早版本。这 shortcuts CLI需要macOS 12（蒙特利）或更高版本。

“权限被拒绝”

授予终端（或克劳德）运行快捷方式的权限：

• 系统设置→ 隐私和安全→ 自动化

“JSON无效”或“解析失败”

您的快捷方式未返回有效的JSON。确保您的快捷方式：

1. 用途 “从输入中获取词典” 或 “词典” 行动
2. 有 “输出” 行动作为最后一步
3. 返回结构化数据，而非纯文本

在快捷方式应用程序中手动测试快捷方式，以验证其输出。

未退回草稿

• 检查草稿应用程序是否已安装并具有草稿
• 手动运行快捷方式： shortcuts run "Drafts - Get All"
• 确保您的快捷方式具有访问草稿的正确权限

高级用法

自定义快捷方式

您可以为特定工作流创建自定义快捷方式：

“草稿-获取任务” （获取标记为#task的草稿）：

1. Get Drafts where Tags contains "task"
2. Get Details (UUID, Content, Tags)
3. Dictionary with details
4. Output as JSON

“草稿-每周审查” （获取最近7天的草稿）：

1. Get Drafts modified in last 7 days
2. Get Details
3. Output as JSON

然后给他们打电话： drafts_run_shortcut 名称：“草稿-每周审阅”

修改快捷方式

您可以自定义内置快捷方式：

• 更改限额（默认为20张汇票）
• 添加更多字段（文件夹、标记状态等）
• 按工作区或文件夹筛选
• 按不同标准排序

只需更新快捷方式应用程序中的快捷方式-MCP服务器将使用最新版本。

发展

构建

npm run build

观看模式

npm run watch

测试快捷方式集成

# Check if shortcuts CLI is available
which shortcuts

# List Drafts shortcuts
shortcuts list | grep "Drafts -"

# Test a shortcut
shortcuts run "Drafts - Get All"

文件

• src/index.ts -主MCP服务器
• src/shortcuts-runner.ts -快捷方式CLI集成
• src/types.ts -TypeScript类型定义
• SHORTCUTS_SETUP.md -详细的快捷方式设置指南

参考文献

• 起草文件
• 苹果快捷方式用户指南
• 模型上下文协议
• 草稿脚本

许可证

麻省理工学院