文档操作服务

Dynalist MCP Server是一个基于Model Context Protocol的服务器,允许AI助手如Claude以编程方式读取、写入和操作Dynalist文档。

  • by cristip73
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 cristip73/dynalist-mcp

使用说明

动态列表MCP服务器

A. 模型上下文协议 服务器 Dynalist.io -无限文档大纲图。

使Claude和其他AI助手能够以编程方式读取、写入和操作Dynalist文档。

特性

读取操作

  • list_文档 -列出您帐户中的所有文档和文件夹
  • 搜索文档 -按名称搜索文档/文件夹(返回ID、URL、类型)
  • read_node_as_markdown -将要点提取为Markdown(支持深度链接、深度限制、注释)
  • search_in_document -在文档中搜索内容(返回父项+可选子项)
  • get_recent_changes -获取在一段时间内创建/修改的节点(具有父上下文)

写入操作

  • send_to_inbox -将项目添加到Dynalist收件箱(支持分层标记)
  • edit_node -修改现有节点(内容、注释、复选框、标题、颜色)
  • insert_node -插入一个新节点
  • insert_nodes_from_markdown -从缩进标记/项目符号列表批量导入

结构操作

  • delete_node -删除一个节点(可选地包括所有子节点)
  • move_node -移动具有显式父节点/索引的节点
  • move_node_relater -相对于另一个节点移动节点+子树(在/as_child之后/之前)

设置

1.获取您的Dynalist API代币

访问https://dynalist.io/developer并生成API令牌。

2.安装依赖项

npm install
npm run build

3.配置克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dynalist": {
      "command": "node",
      "args": ["/FULL/PATH/TO/dynalist-mcp/dist/index.js"],
      "env": {
        "DYNALIST_API_TOKEN": "your_token_here"
      }
    }
  }
}

使用示例

从深层链接中提取子弹

read_node_as_markdown with url: "https://dynalist.io/d/abc123#z=xyz789"

返回保留Markdown的层次结构:

- Parent item
    - Child item
        - Grandchild with checkbox [x]
    - Another child

从markdown批量插入

insert_nodes_from_markdown with:
  file_id: "abc123"
  parent_node_id: "xyz789"
  markdown: "- Item 1\n    - Sub-item\n- Item 2"

在文档中搜索

search_in_document with:
  file_id: "abc123"
  query: "meeting notes"

添加到收件箱

send_to_inbox with content: "Remember to review the PR"

发展

npm run build      # Compile TypeScript
npm run dev        # Watch mode
npm run inspector  # Test with MCP Inspector

MCP检验员测试

DYNALIST_API_TOKEN=your_token npx @modelcontextprotocol/inspector node dist/index.js

许可证

麻省理工学院