@hiveforge/hivemind-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Preston
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# Hivemind MCP Server
+
+An MCP (Model Context Protocol) server for Obsidian worldbuilding vaults that provides AI tools with consistent, canonical context from your fictional worlds.
+
+## What is Hivemind?
+
+Hivemind bridges your Obsidian vault (where you maintain your worldbuilding canon) and AI tools (Claude, ComfyUI, etc.) via the Model Context Protocol. It ensures AI-generated content stays consistent with your established characters, locations, lore, and approved assets.
+
+## Features
+
+- 🔍 **HybridRAG Search**: Combines vector, graph, and keyword search for accurate context retrieval
+- 📚 **Obsidian Native**: Works with standard markdown, YAML frontmatter, and wikilinks
+- 🎨 **Asset Provenance**: Track AI-generated images and their generation settings
+- 🔐 **Local-First**: Your data stays on your machine, with optional cloud deployment
+- ✅ **Canon Management**: Draft → Pending → Canon approval workflow
+- 🚀 **High Performance**: <300ms query latency, supports 1000+ note vaults
+
+## Quick Start
+
+### Installation
+
+```bash
+# Install globally
+npm install -g hivemind-mcp
+
+# Or use with npx (no installation needed)
+npx hivemind-mcp init
+```
+
+### Setup
+
+```bash
+# Interactive setup - creates config.json
+npx hivemind-mcp init
+
+# Validate your configuration
+npx hivemind-mcp validate
+
+# Start the server
+npx hivemind-mcp start
+```
+
+### Configuration for MCP Clients
+
+**Claude Desktop** (`%APPDATA%\Claude\claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "hivemind": {
+      "command": "npx",
+      "args": ["-y", "hivemind-mcp", "start"]
+    }
+  }
+}
+```
+
+**GitHub Copilot** (`~/.copilot/mcp-config.json`):
+```json
+{
+  "mcpServers": {
+    "hivemind": {
+      "type": "local",
+      "command": "npx",
+      "args": ["-y", "hivemind-mcp", "start"],
+      "tools": ["*"]
+    }
+  }
+}
+```
+
+### Manual Configuration
+
+If you prefer to configure manually, create a `config.json`:
+
+```json
+{
+  "vault": {
+    "path": "/path/to/your/obsidian/vault",
+    "watchForChanges": true,
+    "debounceMs": 100
+  },
+  "server": {
+    "transport": "stdio"
+  },
+  "indexing": {
+    "strategy": "incremental",
+    "batchSize": 100,
+    "enableVectorSearch": false,
+    "enableFullTextSearch": true
+  }
+}
+```
+
+## Architecture
+
+```
+Obsidian Vault → File Watcher → Markdown Parser → Knowledge Graph
+                                                         ↓
+                                     ┌───────────────────┴─────────────────┐
+                                     │                                     │
+                              Full-Text Index                      Vector Index
+                                 (SQLite)                            (FAISS)
+                                     │                                     │
+                                     └───────────────────┬─────────────────┘
+                                                         ↓
+                                                  HybridRAG Router
+                                                         ↓
+                                                    MCP Server
+                                                         ↓
+                                              AI Clients (Claude, etc.)
+```
+
+## Development Status
+
+**Current Phase**: Phase 1 - MVP Implementation  
+**Version**: 0.1.0 (Pre-release)
+
+### Roadmap
+
+See [.planning/PROJECT.md](.planning/PROJECT.md) for the active requirements and progress tracking.
+
+**Recently Completed:**
+- [x] Project setup and dependencies
+- [x] Vault reading and file watching (VaultReader, VaultWatcher)
+- [x] Markdown parsing with wikilinks (MarkdownParser)
+- [x] Knowledge graph construction (GraphBuilder, HivemindDatabase)
+- [x] HybridRAG search implementation (SearchEngine)
+- [x] MCP tools (query_character, query_location, search_vault)
+
+**Up Next:**
+- [ ] Testing and validation
+- [ ] ComfyUI integration
+- [ ] Obsidian plugin
+
+## Documentation
+
+- [Project Requirements & Roadmap](.planning/PROJECT.md)
+- [Architecture Research](.planning/research/ARCHITECTURE.md)
+- [Technology Stack](.planning/research/STACK.md)
+- [Features Specification](.planning/research/FEATURES.md)
+
+## License
+
+MIT
+
+## Contributing
+
+This project is currently in early development. Contributions welcome once MVP is stable.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { resolve, join } from 'path';
+import * as readline from 'readline/promises';
+import { stdin as input, stdout as output } from 'process';
+const DEFAULT_CONFIG = {
+    vault: {
+        path: '',
+        watchForChanges: true,
+        debounceMs: 100
+    },
+    server: {
+        transport: 'stdio'
+    },
+    indexing: {
+        strategy: 'incremental',
+        batchSize: 100,
+        enableVectorSearch: false,
+        enableFullTextSearch: true
+    }
+};
+async function init() {
+    console.log('🧠 Hivemind MCP Server - Configuration Setup\n');
+    const rl = readline.createInterface({ input, output });
+    try {
+        // Check if config already exists
+        const configPath = resolve(process.cwd(), 'config.json');
+        if (existsSync(configPath)) {
+            const overwrite = await rl.question('config.json already exists. Overwrite? (y/N): ');
+            if (overwrite.toLowerCase() !== 'y') {
+                console.log('Setup cancelled.');
+                rl.close();
+                return;
+            }
+        }
+        // Ask for vault path
+        const vaultPath = await rl.question('Enter your Obsidian vault path: ');
+        if (!vaultPath.trim()) {
+            console.error('❌ Vault path is required');
+            rl.close();
+            process.exit(1);
+        }
+        const resolvedPath = resolve(vaultPath.trim());
+        if (!existsSync(resolvedPath)) {
+            console.warn(`⚠️  Warning: Path does not exist: ${resolvedPath}`);
+            const proceed = await rl.question('Continue anyway? (y/N): ');
+            if (proceed.toLowerCase() !== 'y') {
+                console.log('Setup cancelled.');
+                rl.close();
+                return;
+            }
+        }
+        // Optional: Enable vector search
+        const enableVector = await rl.question('Enable vector search (experimental)? (y/N): ');
+        // Create config
+        const config = {
+            ...DEFAULT_CONFIG,
+            vault: {
+                ...DEFAULT_CONFIG.vault,
+                path: resolvedPath
+            },
+            indexing: {
+                ...DEFAULT_CONFIG.indexing,
+                enableVectorSearch: enableVector.toLowerCase() === 'y'
+            }
+        };
+        // Write config
+        writeFileSync(configPath, JSON.stringify(config, null, 2));
+        console.log(`\n✅ Configuration saved to ${configPath}`);
+        console.log('\n📝 Next steps:');
+        console.log('  1. Build the project: npm run build');
+        console.log('  2. Start the server: npm start');
+        console.log('  3. Configure your MCP client to connect to this server');
+        rl.close();
+    }
+    catch (error) {
+        console.error('Error during setup:', error);
+        rl.close();
+        process.exit(1);
+    }
+}
+async function start() {
+    const configPath = resolve(process.cwd(), 'config.json');
+    if (!existsSync(configPath)) {
+        console.error('❌ config.json not found. Run "npx hivemind init" first.');
+        process.exit(1);
+    }
+    console.log('🚀 Starting Hivemind MCP Server...\n');
+    // Import and start the server
+    const { startServer } = await import('./index.js');
+    await startServer();
+}
+async function validate() {
+    const configPath = resolve(process.cwd(), 'config.json');
+    console.log('🔍 Validating Hivemind configuration...\n');
+    // Check config exists
+    if (!existsSync(configPath)) {
+        console.error('❌ config.json not found');
+        console.log('   Run "npx hivemind init" to create one');
+        process.exit(1);
+    }
+    // Load and validate config
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        console.log('✅ config.json found and valid JSON');
+        // Check vault path
+        if (!config.vault?.path) {
+            console.error('❌ vault.path is missing in config');
+            process.exit(1);
+        }
+        const vaultPath = resolve(config.vault.path);
+        if (!existsSync(vaultPath)) {
+            console.error(`❌ Vault path does not exist: ${vaultPath}`);
+            process.exit(1);
+        }
+        console.log(`✅ Vault path exists: ${vaultPath}`);
+        // Check for .md files
+        const { readdirSync } = await import('fs');
+        let mdCount = 0;
+        function countMarkdown(dir) {
+            try {
+                const entries = readdirSync(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = join(dir, entry.name);
+                    if (entry.isDirectory() && !entry.name.startsWith('.')) {
+                        countMarkdown(fullPath);
+                    }
+                    else if (entry.isFile() && entry.name.endsWith('.md')) {
+                        mdCount++;
+                    }
+                }
+            }
+            catch (err) {
+                // Skip directories we can't read
+            }
+        }
+        countMarkdown(vaultPath);
+        console.log(`✅ Found ${mdCount} markdown file(s)`);
+        // Check if built
+        const distPath = resolve(process.cwd(), 'dist', 'index.js');
+        if (!existsSync(distPath)) {
+            console.warn('⚠️  dist/index.js not found - run "npm run build"');
+        }
+        else {
+            console.log('✅ Server built (dist/index.js exists)');
+        }
+        console.log('\n✅ Configuration is valid!');
+        console.log('\nTo start the server: npm start');
+    }
+    catch (error) {
+        console.error('❌ Error reading config.json:', error);
+        process.exit(1);
+    }
+}
+// Parse command
+const command = process.argv[2];
+switch (command) {
+    case 'init':
+        init();
+        break;
+    case 'start':
+        start();
+        break;
+    case 'validate':
+        validate();
+        break;
+    default:
+        console.log('Hivemind MCP Server\n');
+        console.log('Usage:');
+        console.log('  npx hivemind init      - Interactive configuration setup');
+        console.log('  npx hivemind validate  - Validate configuration');
+        console.log('  npx hivemind start     - Start the MCP server');
+        process.exit(command ? 1 : 0);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/graph/builder.d.ts

@@ -0,0 +1,47 @@
+import type { VaultNote, KnowledgeGraph } from '../types/index.js';
+import { HivemindDatabase } from './database.js';
+export declare class GraphBuilder {
+    private db;
+    constructor(db: HivemindDatabase);
+    /**
+     * Build knowledge graph from vault notes
+     */
+    buildGraph(notes: VaultNote[]): void;
+    /**
+     * Build relationships from wikilinks in a note
+     */
+    private buildRelationships;
+    /**
+     * Infer relationship type from note types
+     */
+    private inferRelationType;
+    /**
+     * Check if a relationship type should be bidirectional
+     */
+    private isBidirectional;
+    /**
+     * Get reverse relationship type
+     */
+    private getReverseRelationType;
+    /**
+     * Find note by name or ID
+     */
+    private findNoteByNameOrId;
+    /**
+     * Extract ID from wikilink format [[id]] or [[id|alias]]
+     */
+    private extractIdFromWikilink;
+    /**
+     * Get in-memory graph representation
+     */
+    getGraph(): KnowledgeGraph;
+    /**
+     * Incremental update: add or update a single note
+     */
+    updateNote(note: VaultNote, allNotes: VaultNote[]): void;
+    /**
+     * Incremental update: remove a note
+     */
+    removeNote(noteId: string): void;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/graph/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/graph/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAa,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAmB;gBAEjB,EAAE,EAAE,gBAAgB;IAIhC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAwBpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsC1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACH,QAAQ,IAAI,cAAc;IA8B1B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI;IASxD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAGjC"}

package/dist/graph/builder.js

@@ -0,0 +1,182 @@
+export class GraphBuilder {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Build knowledge graph from vault notes
+     */
+    buildGraph(notes) {
+        console.error(`Building knowledge graph from ${notes.length} notes...`);
+        const startTime = Date.now();
+        // First pass: Insert all nodes
+        for (const note of notes) {
+            this.db.upsertNode(note);
+        }
+        // Second pass: Build relationships from wikilinks
+        for (const note of notes) {
+            this.buildRelationships(note, notes);
+        }
+        const elapsed = Date.now() - startTime;
+        const stats = this.db.getStats();
+        console.error(`Knowledge graph built in ${elapsed}ms:`);
+        console.error(`  Nodes: ${stats.nodes}`);
+        console.error(`  Relationships: ${stats.relationships}`);
+        console.error(`  By type:`, stats.byType);
+    }
+    /**
+     * Build relationships from wikilinks in a note
+     */
+    buildRelationships(note, allNotes) {
+        // Extract relationships from wikilinks
+        for (const link of note.links) {
+            // Find the target note
+            const targetNote = this.findNoteByNameOrId(link, allNotes);
+            if (targetNote) {
+                // Infer relationship type based on note types
+                const relType = this.inferRelationType(note, targetNote);
+                // Insert relationship
+                this.db.insertRelationship(note.id, targetNote.id, relType);
+                // For certain relationships, create bidirectional link
+                if (this.isBidirectional(relType)) {
+                    const reverseType = this.getReverseRelationType(relType);
+                    this.db.insertRelationship(targetNote.id, note.id, reverseType);
+                }
+            }
+        }
+        // Extract explicit relationships from frontmatter
+        const frontmatter = note.frontmatter;
+        if (frontmatter.relationships) {
+            for (const rel of frontmatter.relationships) {
+                if (rel.target) {
+                    const targetId = this.extractIdFromWikilink(rel.target);
+                    this.db.insertRelationship(note.id, targetId, rel.type || 'related', { status: rel.status });
+                }
+            }
+        }
+    }
+    /**
+     * Infer relationship type from note types
+     */
+    inferRelationType(source, target) {
+        const sourceType = source.frontmatter.type;
+        const targetType = target.frontmatter.type;
+        // Character → Character
+        if (sourceType === 'character' && targetType === 'character') {
+            return 'knows';
+        }
+        // Character → Location
+        if (sourceType === 'character' && targetType === 'location') {
+            return 'located_in';
+        }
+        // Location → Character
+        if (sourceType === 'location' && targetType === 'character') {
+            return 'has_inhabitant';
+        }
+        // Location → Location
+        if (sourceType === 'location' && targetType === 'location') {
+            return 'connected_to';
+        }
+        // Default
+        return 'related';
+    }
+    /**
+     * Check if a relationship type should be bidirectional
+     */
+    isBidirectional(relType) {
+        const bidirectionalTypes = ['knows', 'connected_to', 'related'];
+        return bidirectionalTypes.includes(relType);
+    }
+    /**
+     * Get reverse relationship type
+     */
+    getReverseRelationType(relType) {
+        const reverseMap = {
+            'knows': 'knows',
+            'connected_to': 'connected_to',
+            'related': 'related',
+            'located_in': 'has_inhabitant',
+            'has_inhabitant': 'located_in',
+        };
+        return reverseMap[relType] || 'related';
+    }
+    /**
+     * Find note by name or ID
+     */
+    findNoteByNameOrId(nameOrId, notes) {
+        const normalized = nameOrId.toLowerCase().trim();
+        // Try exact ID match
+        let note = notes.find(n => n.id === normalized);
+        if (note)
+            return note;
+        // Try by title/name
+        note = notes.find(n => {
+            const fm = n.frontmatter;
+            const title = (fm.title || fm.name || '').toLowerCase();
+            return title === normalized;
+        });
+        if (note)
+            return note;
+        // Try by filename
+        note = notes.find(n => {
+            const fileName = n.fileName.replace(/\.md$/, '').toLowerCase();
+            return fileName === normalized;
+        });
+        return note;
+    }
+    /**
+     * Extract ID from wikilink format [[id]] or [[id|alias]]
+     */
+    extractIdFromWikilink(link) {
+        // Remove [[ and ]]
+        const cleaned = link.replace(/^\[\[/, '').replace(/\]\]$/, '');
+        // Split on | to handle aliases
+        const parts = cleaned.split('|');
+        // Return first part (the actual link target)
+        return parts[0].trim().toLowerCase().replace(/\s+/g, '-');
+    }
+    /**
+     * Get in-memory graph representation
+     */
+    getGraph() {
+        const nodes = this.db.getAllNodes();
+        const edges = [];
+        const adjacencyList = new Map();
+        // Build adjacency list
+        for (const node of nodes) {
+            const rels = this.db.getRelationships(node.id);
+            const neighbors = new Set();
+            for (const rel of rels) {
+                edges.push(rel);
+                // Add both directions to adjacency list
+                neighbors.add(rel.targetId);
+                if (rel.sourceId !== node.id) {
+                    neighbors.add(rel.sourceId);
+                }
+            }
+            adjacencyList.set(node.id, neighbors);
+        }
+        return {
+            nodes: new Map(nodes.map(n => [n.id, n])),
+            edges: new Map(edges.map(e => [e.id, e])),
+            adjacencyList,
+        };
+    }
+    /**
+     * Incremental update: add or update a single note
+     */
+    updateNote(note, allNotes) {
+        // Update node
+        this.db.upsertNode(note);
+        // Rebuild relationships for this note
+        // TODO: Delete old relationships first (needs relationship cleanup)
+        this.buildRelationships(note, allNotes);
+    }
+    /**
+     * Incremental update: remove a note
+     */
+    removeNote(noteId) {
+        this.db.deleteNode(noteId);
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/graph/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/graph/builder.ts"],"names":[],"mappings":"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"}

package/dist/graph/database.d.ts

@@ -0,0 +1,71 @@
+import type { VaultNote, GraphNode, GraphEdge } from '../types/index.js';
+export interface DatabaseConfig {
+    path: string;
+    readonly?: boolean;
+}
+export declare class HivemindDatabase {
+    private db;
+    constructor(config: DatabaseConfig);
+    /**
+     * Ensure database directory exists
+     */
+    private ensureDirectory;
+    /**
+     * Initialize database schema
+     */
+    private initializeSchema;
+    /**
+     * Insert or update a node
+     */
+    upsertNode(note: VaultNote): void;
+    /**
+     * Insert a relationship
+     */
+    insertRelationship(sourceId: string, targetId: string, relType?: string, properties?: Record<string, any>): void;
+    /**
+     * Get a node by ID
+     */
+    getNode(id: string): GraphNode | undefined;
+    /**
+     * Get all nodes
+     */
+    getAllNodes(): GraphNode[];
+    /**
+     * Get nodes by type
+     */
+    getNodesByType(type: string): GraphNode[];
+    /**
+     * Get relationships for a node
+     */
+    getRelationships(nodeId: string): GraphEdge[];
+    /**
+     * Full-text search using FTS5
+     */
+    search(query: string, limit?: number): Array<{
+        id: string;
+        rank: number;
+    }>;
+    /**
+     * Delete a node and its relationships
+     */
+    deleteNode(id: string): void;
+    /**
+     * Clear all data
+     */
+    clear(): void;
+    /**
+     * Get database statistics
+     */
+    getStats(): {
+        nodes: number;
+        relationships: number;
+        byType: {
+            [k: string]: number;
+        };
+    };
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+//# sourceMappingURL=database.d.ts.map