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. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. プルリクエストを作成します

ライセンス

ISC