核心用法
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 证书、域名解析故障将直接导致技能失效