nas mcp
MCP over NAS启动项目,用于将NAS装载的保管库文件夹暴露给MCP客户端(Cursor/Cline样式的工作流) 只读模式.
该存储库在中实施和操作该计划 cursor-plan-mcp-over-nas.md 与:
- Docker编写运行时
- 用于设置、健康检查和阴性测试的帮助脚本
- 用于日常操作的Makefile命令
- 设置、架构、测试和故障排除文档
快速启动
- 复制env文件并根据需要进行编辑:```bash
cp .env.example .env
2. (可选)生成推荐 `00_system` 保管库中的元数据:```bash
bash scripts/init-vault-structure.sh
- 启动MCP文件系统服务器:```bash
make up
4. 检查状态和日志:```bash
make ps
make logs
- 运行运行状况和只读检查:
bash make health make test-readonly make test-negative
常用命令
make up–启动堆栈make down–停止堆栈make restart–重新启动堆栈make logs–尾部集装箱原木make health–基本端点/状态检查make test-readonly验证挂载路径是否为只读make test-negative–验证写/路径遍历保护make docker-config–验证docker compose配置make check–运行本地验证(编写配置+shell语法)make init-vaults–脚手架推荐的vault元数据结构
看 docs/SETUP.md 了解完整的设置和客户端集成步骤。
文档
docs/SETUP.md–环境设置和运行时工作流程docs/ARCHITECTURE.md–系统设计和安全模型docs/TESTING.md–自动化和基于提示的验证计划
