WIP: Caution!!! AI code and probably wrong in many ways though it "runs".

WIP：注意！！！AI 生成的代码，可能有很多问题，不过它“能运行”。

Workspace DB Manager

一个用于管理工作区数据库并集成文件系统的 TypeScript MCP（Model Context Protocol）服务。

功能

• 使用自动发现功能管理 SQLite 数据库
• 实时监控文件系统中的数据库变更
• 数据库连接池和管理
• 自动跟踪数据库并更新状态
• 支持跨数据库操作
• TypeScript/ES Module 架构

入门指南

1. 安装依赖：

npm install

2. 构建 TypeScript 代码：

npm run build

3. 初始化核心数据库：

npm run init-db

4. 启动服务：

npm start

开发

# Run in development mode with auto-reload
npm run dev

# Run tests
npm test

# Build TypeScript
npm run build

持续集成

本项目使用 GitHub Actions 进行持续集成：

• 在 Node.js 20.x、21.x 和 22.x 上运行
• 每次推送和创建拉取请求时自动运行测试
• 检查 TypeScript 编译
• 生成并上传测试覆盖率报告
• 如果代码质量未达到标准，则构建失败

配置

可以通过 WorkspaceConfig 对象配置服务：

const manager = new WorkspaceDBManager({
    watchPaths: ['/path/to/workspace'],
    pollInterval: 1000, // Optional: file system polling interval
    database: {
        verbose: true // Optional: enable verbose database logging
    }
});

数据库操作

自动发现数据库

服务会自动检测并跟踪：

• 新数据库文件
• 数据库修改
• 数据库删除

数据库管理

// List all managed databases
const databases = await manager.listManagedDatabases();

// Get system configuration
const config = await manager.getConfig('some_key');

事件

服务会针对各种操作发出事件：

• database-added：发现新数据库时
• database-changed：数据库被修改时
• database-removed：数据库被删除时
• error：发生错误时
• initialized：服务完成初始化时

测试

# Run all tests
npm test

# Run tests with coverage
npm test -- --coverage

贡献

1. Fork 此仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建拉取请求

许可证

ISC