Outline MCP (Ynishi)

mcp概述

树形结构的知识库 主控程序 服务器。

LLM课程是短暂的。 mcp概述 为他们提供了一个持久的、可编辑的知识树——可以浏览的部分和内容节点(toc)，用属性注释，并在会话中演变。节点与 inject=true 自动包含在会话上下文中。

快速开始

cargo install --path .

克劳德代码(~/.claude.json)

{
  "mcpServers": {
    "outline": {
      "command": "outline-mcp",
      "args": ["/path/to/your-book.json"]
    }
  }
}

如果省略path参数，则默认为 outline-book.json 在当前目录中。

工作流程

shelf  →  select_book  →  toc  →  node_create / node_update / node_move
                                   node_batch_move / node_batch_update / node_query
                                   checklist / import / init / gen_routing
                                   snapshot_create / snapshot_list / snapshot_restore
                                   node_history / dump

1. init --新建一本空书
2. node_create --添加节和内容节点（可选 properties)
3. toc --查看带有编号ID的目录（例如。 1, 2-3).支持 filter 按财产
4. select_book --选择一本书。节点与 inject=true 属性的主体会自动附加（草稿节点除外）
5. checklist --将一节（或整本书）导出为带复选框的Markdown清单
6. node_update --编辑标题、正文、类型、占位符、属性或状态(active/draft)节点的
7. node_move --重新定位或删除节点（带子节点）
8. node_batch_move --在单个原子调用中移动或删除多个节点（需要UUID或UUID前缀ID）
9. node_batch_update --原子性地更新多个节点上的标题/正文/类型/属性/状态
10. node_query --按属性值、状态搜索节点(active/draft)，或类型(section/content)；可选择在结果中包含正文
11. import --从以前导出的JSON文件导入书籍
12. gen_routing --从节点生成Markdown路由表 routing 所有账簿中的财产
13. snapshot_create / snapshot_list / snapshot_restore --整本书版本控制（创建、列表、还原）
14. node_history --查看每个节点的更改日志，包括之前/之后的差异
15. dump --将整本书导出为JSON文件

节点ID

toc 分配人性化的编号ID：

1. Coding Standards
  1-1. Naming Conventions
  1-2. Error Handling
2. Testing
  2-1. Unit Tests
  2-2. Integration Tests

这些ID(1, 1-2, 2-1等）在大多数工具中工作。完整的UUID和标题子字符串匹配也作为回退支持。

备注: node_batch_move 和 node_batch_update 需要UUID或UUID前缀ID。在批处理过程中修改树时，有意拒绝分层toc ID以防止位置漂移。

节点属性

节点可以具有元数据的键值属性：

node_create  title="My Rule"  properties={"inject": "true", "scope": "rust"}

• inject=true --节点主体自动包含在 select_book 输出（上下文注入）
• routing= --将节点标记为 gen_routing 输出。使用 | 分配多个场景（例如。 routing="testing|TDD")
• routing_ref= --覆盖默认值 §ID Title 路由表中的引用（例如。 routing_ref="select_book で全体参照")
• 有价值的房产 "true" 在中显示为标签 toc: 1. My Rule [inject]
• toc 支持过滤： filter={"inject": "true"} 仅显示匹配的节点
• 属性在JSON导出/导入中保留

建筑

src/
├── domain/          # Core model (TemplateBook, TemplateNode, NodeId)
│   ├── model/       # Aggregate root + value objects
│   ├── error.rs     # Domain errors
│   └── repository.rs # BookRepository trait
├── application/     # Use cases
│   ├── service.rs   # BookService (CRUD)
│   └── eject.rs     # EjectService (Markdown/JSON export & import)
├── infra/           # Persistence
│   └── json_store.rs # JSON file repository (atomic write)
└── interface/       # Transport
    └── mcp.rs       # MCP server (rmcp, stdio)

导出格式

Markdown（默认）

# My Runbook

## Design

- [ ] Define requirements
  > requirements list: ___
- [ ] API design
  REST endpoints

JSON

可以重新导入的树形结构格式：

{
  "title": "My Runbook",
  "max_depth": 4,
  "nodes": [
    {
      "title": "Design",
      "node_type": "section",
      "children": [...]
    }
  ]
}

许可证

根据以下任一方式获得许可

• Apache许可证，版本2.0
• MIT许可证

由您选择。