最小权限 MCP 文件助手
通过 MCP 暴露受限文件搜索、读取和摘要能力，并完整记录访问审计。
TypeScriptMCP SDKNode.jsSQLite
目标用户
需要让 AI 安全读取项目资料的开发团队。
面试价值
能具体解释 MCP 架构、能力边界、协议调试和安全设计。
当前交付状态
方案模板
当前仅完成协议边界和安全验收模板，尚无对应代码仓库、可运行 Demo 或测试输出。
验证命令
尚无可执行命令
验证产物
尚无测试或部署产物
目标架构
MCP Server 只暴露白名单根目录下的 Resources 和只读 Tools；输入路径规范化后校验边界，客户端负责用户确认与结果展示。
目标实现步骤
- 01定义 capability 与威胁模型
- 02实现路径沙箱
- 03暴露 Resources 和 Tools
- 04加入审计与协议测试
目标功能
- 目录白名单
- 文件检索
- 资源读取
- 危险操作确认
- 审计日志
预期难点
- 目录穿越防护
- 能力协商
- 传输错误
- 敏感文件过滤
交付与验收
测试策略
- 路径单元测试覆盖相对路径、软链接和目录穿越
- 协议集成测试覆盖初始化、能力发现和工具错误
- 安全测试验证白名单外文件与敏感模式不可读取
部署步骤
- 本地模式使用 stdio 与受限工作目录启动
- 远程模式单独配置 TLS、鉴权和每租户根目录
- Server 升级前运行协议兼容与权限回归测试
验收清单
- Server 仅声明实际支持的 MCP 能力
- 白名单外路径、软链接逃逸和隐藏密钥均被拒绝
- 每次资源读取和工具调用都有审计记录
- 客户端断开或取消后不保留悬挂任务
3 分钟讲解
- 30 秒说明 MCP 统一接入解决的问题
- 60 秒讲 Host、Client、Server 与三类原语
- 60 秒演示目录沙箱和协议测试
- 30 秒总结权限边界与可扩展方向
目标简历表达 · 完成验收后使用
实现最小权限 MCP 文件服务，支持路径沙箱、资源读取、工具调用审计和协议级自动化测试。