Alexandrie

📝 自托管 Markdown 笔记管家

连接自托管 Markdown 笔记系统 Alexandrie,通过 REST API 实现笔记的创建、读取、更新、删除与全文搜索,支持分类管理与 JWT 认证。

收藏
13.6k
安装
3k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Alexandrie 技能通过封装 alexandrie.sh 脚本,为 MCP 环境提供对自托管 Markdown 笔记应用的完整 CRUD 操作能力。用户需先执行 login 获取 JWT Token,随后可通过统一接口管理笔记结构与内容。

关键操作路径:

  • 认证login/logout 管理会话,Token 存储于 /tmp/alexandrie_cookies.txt
  • 结构浏览list 获取完整节点树,get <nodeId> 读取指定笔记内容
  • 内容管理create/update/delete 支持 Markdown 富文本与层级分类(parentId
  • 检索search <query> 实现全文检索

节点类型体系role: 1 为分类/工作区容器,role: 3 为具体文档节点,形成树状知识库结构。

显著优点

1. 自托管隐私保障:数据存储于用户控制的基础设施,规避第三方 SaaS 的数据主权风险
2. Markdown 原生支持:内容格式与 Git、静态站点生成器生态无缝兼容

3. API 设计规范:标准 RESTful 接口,便于与其他自动化工具链集成

4. 轻量脚本封装:单一 Shell 脚本降低依赖复杂度,适合服务器/CI 环境部署

潜在缺点与局限

1. 认证状态外置:JWT 存储于临时文件,多进程/容器环境存在会话隔离问题
2. 无内置冲突解决:并发编辑场景下缺乏乐观锁或版本控制机制

3. 依赖特定实例:配置硬编码指向 eth3rnit3.org 域名,通用性受限

4. 搜索能力边界:全文搜索依赖后端实现,复杂查询语法(如正则、标签筛选)未明确支持

适合人群

  • 追求数据主权的技术用户与小型团队
  • 需要笔记系统与 DevOps 工具链(如自动化文档发布)集成的开发者
  • 已具备自托管基础设施运维能力的用户

常规风险

  • Token 泄露风险:临时 Cookie 文件权限若配置不当,可能导致会话劫持
  • 误删除不可逆delete 操作无回收站机制,重要内容建议前置备份流程
  • 网络可用性依赖:自托管实例的 SSL 证书、域名解析故障将直接导致技能失效

Alexandrie 内容

手动下载zip · 2.9 kB
alexandrie.shtext/x-shellscript
请选择文件