文档结构管理服务

Bike MCP Server是一个为macOS上的Bike大纲应用提供的文档结构管理服务,支持文档的创建、读取、更新和删除操作。

  • by hildersantos
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 hildersantos/bike-mcp-server

使用说明

自行车MCP服务器

MCP(模型上下文协议)服务器 自行车 macOS上的大纲图应用程序。

特性

阅读

  • bike_list_documents -列出所有打开的文档
  • bike_get_document_outline -读取文档结构(支持max_depth)
  • bike_query_rows -使用Bike的轮廓路径语法搜索行

写作

  • bike_create_document -创建具有可选结构的新文档
  • bike_create_rows -添加具有嵌套子项和定位的行
  • bike_update_row -编辑行内容和类型(批量支持)
  • bike_delete_row -删除行(批处理支持)
  • bike_group_rows -将多行分组/移动到父行下

需求

  • macOS(使用AppleScript)
  • Node.js 18+
  • 已安装自行车应用程序

安装

通过桌面扩展(推荐)

  1. 下载 bike-mcp-server.mcpb 从 发布
  2. 双击文件以使用Claude Desktop打开
  3. 单击安装

来源

cd bike-mcp-server
npm install
npm run build

使用Claude Desktop

添加到您的Claude Desktop配置文件(~/Library/Application Support/Claude/claude_desktop_config.json):

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

然后重新启动Claude Desktop。

发展

# Watch mode for development
npm run dev

# Build
npm run build

# Run directly
npm start

运作原理

服务器使用AppleScript与Bike通信 osascript 命令。所有操作都需要Bike在打开文档的情况下运行。

大纲结构以人类可读的缩进文本形式返回:

My Document (doc:abc123)

- First item [row:row-1]
  - Sub-item [row:row-1-1]
- Second item [row:row-2]

示例提示

以下是您可以在Claude Desktop中使用的一些提示:

  1. 探索你的轮廓:“列出我打开的自行车文档,并向我展示第一个文档的大纲”

  2. 创建结构化内容:“创建一个新的自行车文档,其中包含一个项目计划,该计划有3个主要阶段,每个阶段有2-3个任务”

  3. 搜索和转换:“在我的自行车文档中查找所有包含'TODO'的行,并将其转换为任务项”

测试

无需帐户或身份验证。要测试服务器,请执行以下操作:

  1. 在macOS上打开自行车应用程序
  2. 创建或打开包含一些示例内容的文档
  3. 使用Claude Desktop与您的轮廓进行交互

隐私

此服务器不收集、存储或传输任何个人数据。所有通信都是通过AppleScript在Claude Desktop和Bike应用程序之间本地进行的。没有数据离开你的机器。

支持

许可证

麻省理工学院