基于本地Markdown库的轻量MCP服务器开发
004M · reddit · 2026-07-15
作者为解决LLM每次对话需重新解释项目背景的问题,开发了一个基于本地Markdown库的MCP服务器,并分享了核心设计思路: - **工具精简**:模型仅可见10个工具,避免过多工具定义消耗每轮Token并降低误用概率。 - **检索阶梯**:搜索仅返回排序片段,而非全文件;通过维基链接获取ID和标题;再按需拉取大纲、单节内容,最后才请求完整笔记。相比直接全文件RAG节省约60% Token,且成本不随库增长而上升。 - **受控写入**:固定文件夹结构,未知标签作为提案返回而非静默写入;所有写入操作记录于仅追加的审计日志中。 - **权限控制**:使用无状态HTTP、OAuth 2.0 + PKCE及恒定时间Bearer校验,配置缺失时安全失败。 - **访问与判断分离**:配套的Skill负责教导模型如何正确使用这些访问权限(如先搜后写、正确归档),而非仅提供接口。