dotnet-ai-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,100 @@
+# DotNet AI MCP Server
+
+The essential Model Context Protocol server for .NET developers building AI applications.
+
+## Quick Start
+
+### Using npx (Recommended)
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "dotnet-ai": {
+      "command": "npx",
+      "args": ["-y", "dotnet-ai-mcp-server"]
+    }
+  }
+}
+```
+
+### Using VS Code / GitHub Copilot
+
+Add to your VS Code MCP settings:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "dotnet-ai": {
+        "command": "npx",
+        "args": ["-y", "dotnet-ai-mcp-server"]
+      }
+    }
+  }
+}
+```
+
+## Prerequisites
+
+- [.NET 9.0 SDK](https://dotnet.microsoft.com/download) - Required for the underlying dotnet tool
+- Node.js 16+ - For npx
+
+## What This Does
+
+This MCP server provides real, up-to-date code samples from the .NET AI ecosystem:
+
+- **Semantic Kernel** - AI orchestration framework
+- **OpenAI .NET SDK** - Official OpenAI client
+- **MCP C# SDK** - Model Context Protocol for .NET
+- **Microsoft.Extensions.AI** - AI abstractions
+- **Anthropic SDK** - Claude SDK for .NET
+- **Google GenAI** - Gemini SDK for .NET
+- **Vector DBs** - Pinecone, Qdrant, Weaviate, Redis
+
+## Why Use This?
+
+LLMs hallucinate .NET AI APIs. Training data can't keep up with rapidly evolving libraries like Semantic Kernel. This server fetches real code from live GitHub repositories.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `Start_DotNet_Reasoning` | Entry point - lists tracked repositories |
+| `GitHubGetFolders` | Shows folder structure |
+| `GitHubListFiles` | Lists files in folders |
+| `GitHubFetchFiles` | Fetches actual code |
+| `MicrosoftDocsSearch` | Searches Microsoft Learn |
+| `MicrosoftDocsFetch` | Fetches documentation |
+| `MicrosoftCodeSampleSearch` | Finds code samples |
+
+## How It Works
+
+1. The npm package installs the .NET global tool (`dotnet tool install -g DotNetAIMcpServer`)
+2. When invoked via npx, it runs the dotnet tool which communicates via stdio
+3. The tool fetches live code from GitHub and Microsoft Learn
+
+## Manual Installation
+
+If you prefer to install the dotnet tool directly:
+
+```bash
+dotnet tool install -g DotNetAIMcpServer
+```
+
+Then configure your MCP client to use:
+
+```json
+{
+  "mcpServers": {
+    "dotnet-ai": {
+      "command": "dotnet-ai-mcp"
+    }
+  }
+}
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const { existsSync } = require('fs');
+const { join } = require('path');
+const os = require('os');
+
+const TOOL_NAME = 'dotnet-ai-mcp';
+const NUGET_PACKAGE = 'DotNetAIMcpServer';
+
+async function checkDotnetInstalled() {
+    return new Promise((resolve) => {
+        const proc = spawn('dotnet', ['--version'], { stdio: 'pipe' });
+        proc.on('close', (code) => resolve(code === 0));
+        proc.on('error', () => resolve(false));
+    });
+}
+
+async function checkToolInstalled() {
+    return new Promise((resolve) => {
+        const proc = spawn('dotnet', ['tool', 'list', '-g'], { stdio: 'pipe' });
+        let output = '';
+        proc.stdout.on('data', (data) => { output += data.toString(); });
+        proc.on('close', () => {
+            resolve(output.toLowerCase().includes(NUGET_PACKAGE.toLowerCase()));
+        });
+        proc.on('error', () => resolve(false));
+    });
+}
+
+async function installTool() {
+    console.error(`Installing ${NUGET_PACKAGE}...`);
+    return new Promise((resolve, reject) => {
+        const proc = spawn('dotnet', ['tool', 'install', '-g', NUGET_PACKAGE], {
+            stdio: 'inherit'
+        });
+        proc.on('close', (code) => {
+            if (code === 0) resolve();
+            else reject(new Error(`Failed to install ${NUGET_PACKAGE}`));
+        });
+        proc.on('error', reject);
+    });
+}
+
+async function runTool() {
+    // On Windows, the tool might be in a different location
+    const isWindows = os.platform() === 'win32';
+    const toolPath = isWindows
+        ? join(os.homedir(), '.dotnet', 'tools', `${TOOL_NAME}.exe`)
+        : join(os.homedir(), '.dotnet', 'tools', TOOL_NAME);
+
+    // Try running the tool directly first
+    const proc = spawn(TOOL_NAME, [], {
+        stdio: 'inherit',
+        shell: isWindows
+    });
+
+    proc.on('error', () => {
+        // If direct execution fails, try the full path
+        const proc2 = spawn(toolPath, [], { stdio: 'inherit' });
+        proc2.on('error', (err) => {
+            console.error(`Error running ${TOOL_NAME}: ${err.message}`);
+            process.exit(1);
+        });
+    });
+
+    proc.on('close', (code) => {
+        process.exit(code || 0);
+    });
+}
+
+async function main() {
+    try {
+        // Check if .NET is installed
+        const dotnetInstalled = await checkDotnetInstalled();
+        if (!dotnetInstalled) {
+            console.error('ERROR: .NET SDK is not installed.');
+            console.error('Please install .NET 9.0 SDK from: https://dotnet.microsoft.com/download');
+            process.exit(1);
+        }
+
+        // Check if the tool is installed
+        const toolInstalled = await checkToolInstalled();
+        if (!toolInstalled) {
+            await installTool();
+        }
+
+        // Run the tool
+        await runTool();
+    } catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+}
+
+main();

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "dotnet-ai-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP Server for .NET AI development - provides real code samples from Semantic Kernel, OpenAI .NET, MCP C# SDK, and more",
+  "bin": {
+    "dotnet-ai-mcp-server": "./bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.js"
+  },
+  "keywords": [
+    "mcp",
+    "dotnet",
+    "ai",
+    "semantic-kernel",
+    "openai",
+    "claude",
+    "copilot",
+    "llm",
+    "model-context-protocol"
+  ],
+  "author": "Arbel Hodesman",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ArbelH/dotnet-ai-mcp-server"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+
+const NUGET_PACKAGE = 'DotNetAIMcpServer';
+
+async function checkDotnetInstalled() {
+    return new Promise((resolve) => {
+        const proc = spawn('dotnet', ['--version'], { stdio: 'pipe' });
+        proc.on('close', (code) => resolve(code === 0));
+        proc.on('error', () => resolve(false));
+    });
+}
+
+async function checkToolInstalled() {
+    return new Promise((resolve) => {
+        const proc = spawn('dotnet', ['tool', 'list', '-g'], { stdio: 'pipe' });
+        let output = '';
+        proc.stdout.on('data', (data) => { output += data.toString(); });
+        proc.on('close', () => {
+            resolve(output.toLowerCase().includes(NUGET_PACKAGE.toLowerCase()));
+        });
+        proc.on('error', () => resolve(false));
+    });
+}
+
+async function installTool() {
+    console.log(`Installing ${NUGET_PACKAGE} dotnet tool...`);
+    return new Promise((resolve, reject) => {
+        const proc = spawn('dotnet', ['tool', 'install', '-g', NUGET_PACKAGE], {
+            stdio: 'inherit'
+        });
+        proc.on('close', (code) => {
+            if (code === 0) {
+                console.log(`${NUGET_PACKAGE} installed successfully!`);
+                resolve();
+            } else {
+                // Tool might already be installed, try update
+                const updateProc = spawn('dotnet', ['tool', 'update', '-g', NUGET_PACKAGE], {
+                    stdio: 'inherit'
+                });
+                updateProc.on('close', (updateCode) => {
+                    if (updateCode === 0) {
+                        console.log(`${NUGET_PACKAGE} updated successfully!`);
+                        resolve();
+                    } else {
+                        reject(new Error(`Failed to install/update ${NUGET_PACKAGE}`));
+                    }
+                });
+                updateProc.on('error', reject);
+            }
+        });
+        proc.on('error', reject);
+    });
+}
+
+async function main() {
+    try {
+        // Check if .NET is installed
+        const dotnetInstalled = await checkDotnetInstalled();
+        if (!dotnetInstalled) {
+            console.log('\n========================================');
+            console.log('  .NET SDK Required');
+            console.log('========================================');
+            console.log('This package requires .NET 9.0 SDK.');
+            console.log('Please install from: https://dotnet.microsoft.com/download');
+            console.log('========================================\n');
+            return; // Don't fail, just warn
+        }
+
+        // Check if already installed
+        const toolInstalled = await checkToolInstalled();
+        if (toolInstalled) {
+            console.log(`${NUGET_PACKAGE} is already installed.`);
+            return;
+        }
+
+        // Install the tool
+        await installTool();
+    } catch (error) {
+        console.error(`Warning: Could not install ${NUGET_PACKAGE}: ${error.message}`);
+        console.error('You can install it manually with: dotnet tool install -g DotNetAIMcpServer');
+    }
+}
+
+main();