nas MCP

nas mcp

MCP over NAS启动项目，用于将NAS装载的保管库文件夹暴露给MCP客户端（Cursor/Cline样式的工作流） 只读模式.

该存储库在中实施和操作该计划 cursor-plan-mcp-over-nas.md 与：

• Docker编写运行时
• 用于设置、健康检查和阴性测试的帮助脚本
• 用于日常操作的Makefile命令
• 设置、架构、测试和故障排除文档

______________________________________________________________________

快速启动

1. 复制env文件并根据需要进行编辑：

cp .env.example .env

1. （可选）生成推荐 00_system 保管库中的元数据：

bash scripts/init-vault-structure.sh

1. 启动MCP文件系统服务器：

make up

1. 检查状态和日志：

make ps
make logs

1. 运行运行状况和只读检查：

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 –自动化和基于提示的验证计划