get the mcp up and running

Author: MelbourneDeveloper

Samples/NucliaDbClient.McpServer/NucliaDbClient.McpServer.csproj

@@ -2,9 +2,10 @@
   <PropertyGroup>
     <OutputType>Exe</OutputType>
     <TargetFramework>net9.0</TargetFramework>
-    <NoWarn>CA1303;CA2000</NoWarn>
+    <NoWarn>CA1303;CA2000;CA2007;IDE0005</NoWarn>
   </PropertyGroup>
   <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.Hosting" Version="9.0.0" />
     <PackageReference Include="Microsoft.Extensions.Http" Version="9.0.0" />
     <PackageReference Include="ModelContextProtocol" Version="0.4.0-preview.2" />
     <PackageReference Include="Urls" Version="1.0.0" />

Samples/NucliaDbClient.McpServer/Program.cs

@@ -1,16 +1,24 @@
 using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Logging;
+using ModelContextProtocol.Server;
 using NucliaDB.Mcp;
 
+var builder = Host.CreateApplicationBuilder(args);
+
+// Configure logging to stderr to not interfere with stdio MCP protocol
+builder.Logging.AddConsole(consoleLogOptions =>
+{
+    consoleLogOptions.LogToStandardErrorThreshold = LogLevel.Trace;
+});
+
 // Get the NucliaDB base URL from environment or use default
 var nucleaBaseUrl =
     Environment.GetEnvironmentVariable("NUCLIA_BASE_URL") ?? "http://localhost:8080/api/v1";
 
-// Create a simple HTTP client factory
-var services = new ServiceCollection();
-
 // Configure HttpClient with base URL
-services.AddHttpClient(
-    "default",
+builder.Services.AddHttpClient(
+    string.Empty,
     client =>
     {
         client.BaseAddress = new Uri(nucleaBaseUrl);
@@ -19,13 +27,13 @@
 );
 
 // Add the NucliaDB tools to DI
-services.AddSingleton<NucliaDbTools>();
-
-var serviceProvider = services.BuildServiceProvider();
+builder.Services.AddSingleton<NucliaDbTools>();
 
-// TODO: Wire up MCP server when ModelContextProtocol API stabilizes
-Console.WriteLine("NucliaDB MCP Server - MCP tools generated successfully!");
-Console.WriteLine($"Configured for NucliaDB at: {nucleaBaseUrl}");
-Console.WriteLine("Ready to integrate with ModelContextProtocol when API is stable.");
+// Add MCP server with stdio transport and tools from assembly
+builder.Services
+    .AddMcpServer()
+    .WithStdioServerTransport()
+    .WithToolsFromAssembly();
 
-await Task.CompletedTask.ConfigureAwait(false);
+var host = builder.Build();
+await host.RunAsync();

Samples/NucliaDbClient.McpServer/run-for-claude.sh

@@ -3,17 +3,41 @@
 # Add the NucliaDB MCP server to Claude Code
 # This allows Claude Code to interact with NucliaDB via the Model Context Protocol
 
+set -e
+
 # Get the absolute path to the project directory
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_PATH="$SCRIPT_DIR/NucliaDbClient.McpServer.csproj"
 
+# Find the dotnet executable
+DOTNET_PATH=$(which dotnet)
+
+echo "Configuring NucliaDB MCP server for Claude Code..."
+echo "  Script directory: $SCRIPT_DIR"
+echo "  Project path: $PROJECT_PATH"
+echo "  Dotnet path: $DOTNET_PATH"
+echo ""
+
 # Add the MCP server to Claude Code configuration
-claude mcp add nuclia-db dotnet run --project "$PROJECT_PATH" --env NUCLIA_BASE_URL=http://localhost:8080/api/v1
+# The command structure is: claude mcp add [options] <name> [--env KEY=value] -- <command> [args...]
+claude mcp add --transport stdio nucliadb-mcp --env NUCLIA_BASE_URL=http://localhost:8080/api/v1 -- "$DOTNET_PATH" run --project "$PROJECT_PATH" --no-build
 
-echo "NucliaDB MCP server added to Claude Code!"
 echo ""
-echo "Make sure NucliaDB is running before using the MCP tools:"
-echo "  cd $SCRIPT_DIR && ./start-mcp-server.sh"
+echo "✓ NucliaDB MCP server added to Claude Code!"
+echo ""
+echo "Next steps:"
+echo "  1. Make sure NucliaDB is running:"
+echo "     cd $SCRIPT_DIR && docker-compose up -d"
+echo ""
+echo "  2. Verify the MCP server is configured:"
+echo "     claude mcp list"
+echo ""
+echo "  3. Test the connection:"
+echo "     The server should appear as 'nucliadb-mcp' with a ✓ or ✗ status"
 echo ""
-echo "You can verify the server is configured by running:"
-echo "  claude-code mcp list"
+echo "Available MCP tools:"
+echo "  - Knowledge box management (get, create, delete)"
+echo "  - Search (full-text, semantic, catalog)"
+echo "  - Ask (question-answering)"
+echo "  - Resources (CRUD operations)"
+echo "  - And 100+ more NucliaDB API operations!"