螺纹盒mcp
ThreadBox：用于AI代理工件的虚拟文件系统。Dart MCP服务器为每个Git工作树提供隔离的、版本化的沙盒。
特性
- MCP工具:
write_file,read_file,list_directory,export_zip - 仅附加不变性 具有完整版本历史记录
- 基于UUID的blob寻址 用于唯一文件标识
- Git工作树隔离 用于会话管理
- 异步SQLite存储 为了可靠的持久性
安装
确保您已安装Dart SDK，然后：
dart pub get用法
运行MCP服务器：
dart run bin/threadbox_mcp.dart或者编译为本机可执行文件：
dart compile exe bin/threadbox_mcp.dart -o threadbox_mcp
./threadbox_mcp环境变量
THREADBOX_DB：SQLite数据库文件的路径（默认值：threadbox.db)
MCP工具
write_file
使用自动版本控制将文件写入虚拟文件系统。
参数：
path（必填）：相对于工作台的文件路径content（必填）：文件内容（文本或base64编码）worktree（可选）：用于隔离的Git工作树标识符
read_file
从虚拟文件系统读取文件的最新版本。
参数：
path（必填）：相对于工作台的文件路径worktree（可选）：用于隔离的Git工作树标识符
list_directory
列出虚拟文件系统目录中的所有文件。
参数：
path（必填）：相对于工作树的目录路径worktree（可选）：用于隔离的Git工作树标识符
export_zip
将文件从目录导出为ZIP存档（占位符）。
参数：
path（必需）：要导出的目录路径worktree（可选）：用于隔离的Git工作树标识符
发展
运行测试
dart test代码检查
dart analyze建筑
- 存储层 (
lib/src/storage.dart)：具有UUID主键的基于SQLite的存储 - MCP服务器 (
lib/src/server.dart)：使用工具端点实现MCP协议 - 主条目 (
bin/threadbox_mcp.dart)：服务器初始化和启动
许可证
有关详细信息，请参阅LICENSE文件。