V3 Installation

V3 Installation & Setup

Complete guide to installing and configuring DaemonsMCP Version 3.

---

Prerequisites

Required Software

1. .NET 8.0 SDK or later

   • Download: https://dotnet.microsoft.com/download
   • Verify: dotnet --version

2. SQL Server 2019+

   • Options:
     • SQL Server Express (free, local development)
     • SQL Server Developer Edition (free, full features)
     • SQL Server Standard/Enterprise (production)
   • Download: https://www.microsoft.com/sql-server/sql-server-downloads

3. Visual Studio 2022 or VS Code usually both.

   • VS 2022: https://visualstudio.microsoft.com/
     • used to run and edit the server for the config and Angular config viewer.
   • VS Code: https://code.visualstudio.com/ + C# extension
     • used to run the config viewer app.

Optional (for Web UI)

4. Node.js 20+ and npm 10+

   • Download: https://nodejs.org/
   • Verify: node --version and npm --version

5. Angular CLI 18+

   • Install: npm install -g @angular/cli
   • Verify: ng version

---

Installation Steps

1. Clone the Repository

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

Or download ZIP from GitHub and extract.

---

2. Database Setup

Option A: SQL Server Express (Recommended for Development)

1. Install SQL Server Express:

   • Download SQL Server Express with LocalDB
   • Accept defaults during installation

2. Verify Installation:

   sqlcmd -S localhost -E -Q "SELECT @@VERSION"

Option B: SQL Server Developer/Standard

1. Install SQL Server with SQL Server Management Studio (SSMS)
2. Note your server name (usually localhost or .\SQLEXPRESS)

---

3. Configure Connection String

Edit server/DaemonsMCP.Api/appsettings.json:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=DaemonsMCP;Trusted_Connection=true;TrustServerCertificate=true"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.EntityFrameworkCore": "Warning"
    }
  }
}

Connection String Variations:

• Windows Authentication (recommended):

  Server=localhost;Database=DaemonsMCP;Trusted_Connection=true;TrustServerCertificate=true

• SQL Authentication:

  Server=localhost;Database=DaemonsMCP;User Id=sa;Password=YourPassword;TrustServerCertificate=true

• LocalDB:

  Server=(localdb)\\mssqllocaldb;Database=DaemonsMCP;Trusted_Connection=true

• Named Instance:

  Server=localhost\\SQLEXPRESS;Database=DaemonsMCP;Trusted_Connection=true;TrustServerCertificate=true

---

4. Create Database & Run Migrations

For the Server, I usually use Visual Studio and its Package Manager Console. Navigate to the API project:

cd server/DaemonsMCP.Api

Install EF Core Tools (if not already installed)

dotnet tool install --global dotnet-ef

Run Migrations

dotnet ef database update

You should see:

Build started...
Build succeeded.
Applying migration '20250101000000_InitialCreate'.
Done.

Verify Database Creation

Using SSMS or sqlcmd:

USE DaemonsMCP;
GO

SELECT TABLE_NAME 
FROM INFORMATION_SCHEMA.TABLES 
WHERE TABLE_TYPE = 'BASE TABLE';

You should see tables:

• Projects
• FileSystemNodes
• ObjectHierarchy
• Items
• ItemTypes
• StatusTypes

---

5. Build the Solution

cd server
dotnet build

Verify no errors in:

• DaemonsMCP.Domain
• DaemonsMCP.Application
• DaemonsMCP.Infrastructure
• DaemonsMCP.Api
• Set DaemonsMCP.Api as the default and run it. Verify by browsing to https://localhost:44356/swagger/index.html

---

6. Configure MCP for Claude Desktop

Locate Config File

Windows:

%APPDATA%\Claude\claude_desktop_config.json

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Add DaemonsMCP V3

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "daemons3mcp": {
      "command": "C:\\YourPath\\DaemonsMCP\\server\\DaemonsMCP\\bin\\Debug\\net9.0-windows7.0\\Daemons3MCP.exe",
      "args": []
    }
  }
}

---

7. Test the Installation

Start Claude Desktop

1. Close Claude Desktop completely
2. Reopen Claude Desktop
3. Wait for MCP server to initialize (check system tray icon)

Verify Connection

In Claude, ask:

List available MCP tools

You should see tools like:

• daemons3mcp:list-projects
• daemons3mcp:search-file-system
• daemons3mcp:search-object-hierarchy
• daemons3mcp:search-items

Create Your First Project

Ask Claude:

Add a new project called 'TestProject' at C:\Code\MyProject

Verify in Database

SELECT * FROM Projects;

---

Optional: Angular Web Interface Setup

Note: this is usually best done from VS Code.

1. Navigate to Client Directory

cd client/config-viewer

2. Install Dependencies

npm install

If you encounter peer dependency warnings:

npm install --legacy-peer-deps

3. Configure API Endpoint

Verify src/environments/environment.ts:

export const environment = {
  production: false,
  apiUrl: 'https://localhost:44356'
};

4. Start Backend API

In Visual Studio or terminal:

cd server/DaemonsMCP.Api
dotnet run

Verify at: https://localhost:44356/swagger/index.html

5. Configure CORS

Ensure server/DaemonsMCP.Api/Program.cs has CORS enabled:

builder.Services.AddCors(options =>
{
    options.AddPolicy("LocalDev",
        policy =>
        {
            policy.WithOrigins("http://localhost:4200")
                  .AllowAnyHeader()
                  .AllowAnyMethod();
        });
});

// After app.Build()
app.UseCors("LocalDev");

6. Start Angular Dev Server

This is usually done from VS Code terminal.

ng serve

Navigate to: http://localhost:4200

You should see the DaemonsMCP Config Viewer interface.

---

Troubleshooting

Database Connection Fails

Error: "A connection was successfully established with the server, but then an error occurred during the login process."

Solution:

1. Verify SQL Server is running: services.msc → find SQL Server
2. Check server name in connection string
3. Ensure Windows Authentication or correct SQL credentials
4. Add TrustServerCertificate=true to connection string

Migration Fails

Error: "Build failed."

Solution:

1. Ensure you're in DaemonsMCP.Api directory
2. Clean and rebuild: dotnet clean && dotnet build
3. Check for compilation errors in all projects

MCP Server Not Starting

Error: Claude shows "MCP server error"

Solution:

1. Verify .NET 8.0 is installed: dotnet --version
2. Check absolute path in claude_desktop_config.json
3. Use forward slashes in path (even Windows)
4. Check Claude logs: %APPDATA%\Claude\logs\mcp*.log

CORS Errors in Angular

Error: "Access to XMLHttpRequest blocked by CORS policy"

Solution:

1. Ensure backend API is running at https://localhost:44356
2. Verify CORS policy includes http://localhost:4200
3. Navigate to https://localhost:44356/health and accept cert
4. Restart Angular dev server

Port Already in Use

Error: "Failed to bind to address https://127.0.0.1:44356"

Solution:

1. Change port in launchSettings.json:

   "applicationUrl": "https://localhost:44357;http://localhost:5001"

2. Update environment.ts in Angular client
3. Update CORS origins in API

---

Next Steps

• Configuration Guide - Configure projects and indexing
• Quick Start Tutorial - Learn basic operations
• MCP Tools Reference - Explore available tools
• Angular Client Guide - Use the web interface

---

Uninstallation

Remove Database

DROP DATABASE DaemonsMCP;

Remove from Claude Desktop

Remove the daemonsmcp-v3 entry from claude_desktop_config.json

Delete Files

Delete the cloned repository directory.