Version 3.0

DaemonsMCP Version 3 (D3Core) Documentation

Enterprise-Grade Code Intelligence for AI Assistants

Version 3 represents a complete architectural overhaul of DaemonsMCP, transitioning from file-based storage to a full SQL Server + Entity Framework Core stack with clean architecture patterns, REST API access, and a modern Angular management interface.

---

🎯 What's New in V3

• SQL Server Backend: Full relational database with Entity Framework Core
• Clean Architecture: Domain, Application, Infrastructure, and Host layers
• MediatR CQRS: Command/query separation for maintainable code
• REST API: Full-featured API alongside MCP protocol support
• Angular UI: Web-based configuration and management interface
• Real-time Indexing: File watcher with debounced batch processing
• Hierarchical Items: Flexible tree-based organization for notes, tasks, and metadata
• Advanced Code Parsing: Roslyn-powered namespace, class, and method extraction
• Multi-Project Support: Manage multiple codebases simultaneously

---

📚 Documentation Index

Getting Started

• Installation & Setup
• Configuration Guide

Architecture

• System Architecture
• Database Schema
• Application Layers

Features

• File System Management
• Code Indexing
• Hierarchical Items
• MCP Tools Reference
• REST API Reference

Web Interface

• Angular Client Setup
• UI Features Guide

Advanced Topics

• Extending the System
• Performance Tuning
• Troubleshooting

Migration

• Migrating from V2.4

---

🏗️ Architecture Overview

┌─────────────────────────────────────────────────────────────┐
│                     Client Applications                     │
├──────────────────────┬──────────────────────────────────────┤
│   Claude Desktop     │        Web Browser                   │
│   (MCP Protocol)     │        (Angular SPA)                 │
└──────────┬───────────┴────────────┬─────────────────────────┘
           │                        │
           │ JSON-RPC               │ HTTP/REST
           │                        │
┌──────────▼───────────┐            │
│  DaemonsMCP Host     │            │
└──────────┬───────────┘  ┌─────────▼──────────────────────────────────────────┐
           │              │                   ASP.NET Core API                 │
           │              └─┬──────────────────────────────────────────────────┘
           │                │
           └────────┬───────┘
                    │ MediatR Commands/Queries
                    │
         ┌──────────▼──────────────────────┐
         │    Application Layer (CQRS)     │
         │  - FileSystem Handlers          │
         │  - Items Handlers               │
         │  - Indexing Handlers            │
         │  - Validation & Business Logic  │
         └──────────┬──────────────────────┘
                    │
         ┌──────────▼──────────────────────┐
         │    Infrastructure Layer         │
         │  - EF Core DbContext            │
         │  - File Watcher Service         │
         │  - Roslyn Code Parser           │
         └──────────┬──────────────────────┘
                    │
         ┌──────────▼──────────────────────┐
         │       SQL Server Database       │
         │  - Projects                     │
         │  - FileSystemNodes              │
         │  - ObjectHierarchy              │
         │  - Items & Types                │
         └─────────────────────────────────┘

---

🚀 Quick Start

Prerequisites

• .NET 8.0 SDK or later
• SQL Server 2019+ (Express/Developer/Standard/Enterprise)
• Node.js 20+ and npm 10+ (for Angular client)
• Visual Studio 2022 or VS Code

Basic Setup (5 minutes)

1. Clone the V3 branch:

   git clone -b V3 https://github.com/yourusername/DaemonsMCP.git
   cd DaemonsMCP

2. Configure Database: Edit server/DaemonsMCP.Api/appsettings.json:

   {
     "ConnectionStrings": {
       "DefaultConnection": "Server=localhost;Database=DaemonsMCP;Trusted_Connection=true;TrustServerCertificate=true"
     }
   }

3. Run Migrations:

   cd server/DaemonsMCP.Api
   dotnet ef database update

4. Start the Host:

   dotnet run

5. Configure Claude Desktop: Add to claude_desktop_config.json:

   {
     "mcpServers": {
       "daemonsmcp-v3": {
         "command": "dotnet",
         "args": ["run", "--project", "C:/path/to/DaemonsMCP/server/DaemonsMCP.Api"],
         "env": {
           "ASPNETCORE_ENVIRONMENT": "Development"
         }
       }
     }
   }

See Installation & Setup for detailed instructions.

---

🔑 Key Concepts

Projects

Projects define the root directories Claude can access. Each project has:

• Unique ID and name
• Root path (all operations are scoped within this path)
• Security isolation (no directory traversal attacks)
• Independent file system indexing

File System Nodes

All files and folders are tracked as nodes with:

• Hierarchical parent-child relationships
• Relative paths from project root
• Metadata (size, type, timestamps)
• Full-text search capabilities

Object Hierarchy

Code structures parsed from C# files:

• Namespaces → Interfaces/Classes → Methods/Properties/Fields/Events
• Fully qualified names and signatures
• File references for quick navigation
• Searchable by identifier name

Items System

Flexible hierarchical tree for organizing:

• Development notes and documentation
• Task lists and workflows
• Code annotations and references
• Custom taxonomies with Types and Status

---

🛠️ Common Tasks

Add a New Project

Via MCP:

Note, Claude does not have access to add a project yet.

Via API: Note after starting API browse to https://localhost:44356/swagger/index.html and use the UI. where name is the Name to refer to this project when chatting with the AI assistant. rootPath is the folder you are sharing. description is used to pass any global project instructions to the AI assistant.

POST https://localhost:44356/api/projects
{
  "name": "MyApp", 
  "rootPath": "C:\\Code\\MyApp",
  "description": "My application codebase"
}

Search for Files

Via MCP:

Ask Claude: "Search for files containing 'controller' in MyApp"

Via API:

GET https://localhost:44356/api/filesystem/search?projectId=1&filter=controller&includeFiles=true

Browse Code Structure

Via MCP:

Ask Claude: "Show me all classes in the MyApp.Services namespace"

Via API:

GET https://localhost:44356/api/hierarchy/search?projectId=1&searchTerm=MyApp.Services&identifierTypeId=3

---

📊 System Requirements

Minimum

• Windows 10/11 or Windows Server 2019+
• 4 GB RAM
• SQL Server Express 2019+
• .NET 8.0 Runtime
• 500 MB disk space

Recommended

• 8 GB RAM
• SQL Server Developer/Standard 2022+
• SSD storage
• Dedicated database server for multi-user scenarios

---

🆚 V2.4 vs V3 Comparison

Feature	V2.4	V3 (D3Core)
Storage	PackedTables (files)	SQL Server + EF Core
Setup Complexity	Minimal	Moderate
Configuration	JSON file	Database + JSON
Scalability	Small codebases	Enterprise scale
Web Interface	None	Full Angular SPA
REST API	None	Complete REST API
Multi-user	No	Yes (via API)
Real-time Updates	Manual	File watcher + debouncing
Code Parsing	Basic	Advanced (Roslyn)
Extensibility	Limited	Highly extensible

---

🤝 Contributing

See Extending the System for information on:

• Adding new MCP tools
• Creating custom command handlers
• Extending the domain model
• Building UI features

---

📝 License

MIT License in the sources.

---

🔗 Quick Links

• GitHub Repository
• Report Issues
• V2.4 Documentation
• Main Wiki Home