DimonSmart.NugetMcpServer DimonSmart

NugetMcpServer

A powerful MCP server for getting accurate interface and enum definitions from NuGet packages. It helps reduce LLM hallucinations by giving precise information about real package APIs.

Overview

This application is not just a demo. It is a useful MCP server that reduces LLM hallucinations by giving accurate, up-to-date information about methods and types in specific NuGet package versions. Instead of using old training data, language models can ask for real package metadata and interface definitions directly from NuGet.

The server uses the Model Context Protocol (MCP). This makes it easy to connect with AI assistants and development tools. It gives real-time access to package information, helping developers and AI systems make better decisions about API usage.

You can use this server with OllamaChat, VS Code with Copilot, and other MCP-compatible clients.

Features

• Real-time extraction of interfaces and enums from NuGet packages
• Smart package search with AI-enhanced keyword generation
• Two-phase search: direct search + AI fallback for better results
• Package popularity ranking by download count
• Reduces LLM hallucinations by giving accurate API information
• Supports specific package versions or latest version
• Supports generic types with correct C# formatting
• Uses STDIO for client communication
• Includes a time utility tool for basic server checks
• Built with .NET 9.0 for good performance
• Easy to integrate with VS Code, OllamaChat, and other MCP clients

Prerequisites

• .NET 9.0 SDK or higher
• A compatible MCP client for testing (for example, OllamaChat)

Installation

Option 1: Install via WinGet (Recommended)

You can install NugetMcpServer using WinGet:

winget install DimonSmart.NugetMcpServer

After installation, you can add the server to VS Code and other MCP-compatible clients. For VS Code:

1. Install the server using the command above.
2. Open VS Code settings and search for "MCP".
3. Add NugetMcpServer to your MCP servers configuration.
4. The server executable (NugetMcpServer.exe) will be in your system PATH.

Option 2: Build from Source

1. Clone this repository.
2. Build the application:

   dotnet build
   

3. Run the server:

   dotnet run
   

Project Structure

• Program.cs - Main entry point that configures and runs the MCP server
• TimeTool.cs - Utility tool for time-related functions (namespace NugetMcpServer)
• Tools/GetInterfaceDefinitionTool.cs - Extracts interface definitions from NuGet packages
• Tools/ListInterfacesTool.cs - Lists all interfaces in NuGet packages
• Tools/GetEnumDefinitionTool.cs - Extracts enum definitions from NuGet packages
• Services/NuGetPackageService.cs - Works with NuGet packages
• Services/InterfaceFormattingService.cs - Formats interface definitions
• Services/EnumFormattingService.cs - Formats enum definitions
• Services/InterfaceInfo.cs - Model for interface information
• Services/InterfaceListResult.cs - Response model for interface listing
• Common/McpToolBase.cs - Base class for MCP tools
• Extensions/ - Extension methods for string formatting and exception handling

Implementation Details

The server uses the .NET Generic Host and includes:

• Console logging set to trace level
• MCP server registered with STDIO transport
• Automatic discovery and registration of tools
• HttpClient service for downloading NuGet packages
• NuGetPackageService for package operations
• InterfaceFormattingService and EnumFormattingService for code formatting

Available Tools

TimeTool

• GetCurrentTime() - Returns the current server time in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ)

Interface Tools

• GetInterfaceDefinition(packageId, interfaceName?, version?) - Gets the C# interface definition from a NuGet package. Parameters: packageId (NuGet package ID), interfaceName (optional, short name without namespace), version (optional, defaults to latest)
• ListInterfaces(packageId, version?) - Lists all public interfaces in a NuGet package. Returns package ID, version, and the list of interfaces

Enum Tools

• GetEnumDefinition(packageId, enumName, version?) - Gets the C# enum definition from a NuGet package. Parameters: packageId (NuGet package ID), enumName (short name without namespace), version (optional, defaults to latest)

Package Search Tools

• SearchPackages(query, maxResults?, fuzzySearch?) - Searches for NuGet packages by description or functionality.
  • Standard search mode (fuzzySearch=false, default): Uses original query terms only
  • Fuzzy search mode (fuzzySearch=true): Enhances results by combining standard search with AI-generated package name alternatives
  • AI analyzes user's functional requirements and generates 3 most likely package names (e.g., "maze generation" → "MazeGenerator MazeBuilder MazeCreator")
  • Returns up to 50 most popular packages with details including download counts, descriptions, and project URLs
  • Results are sorted by popularity (download count) for better relevance

MCP Server Response Examples

Here are examples of server responses from the MCP tools using DimonSmart.MazeGenerator as a sample package:

GetInterfaceDefinition Example

User Query Example

A user might ask:

> "I want to generate mazes in my .NET application. Is there a package for that? Can you show me the interface for DimonSmart.MazeGenerator so I can see how to use it?"

The agent would use the MCP server to get the interface definition:

Request:

{
  "name": "f1e_GetInterfaceDefinition",
  "parameters": {
    "packageId": "DimonSmart.MazeGenerator",
    "interfaceName": "IMazeGenerator",
    "version": ""
  }
}

Response (actual MCP server output):

{
  "result": "namespace DimonSmart.MazeGenerator\n{\n    /// \n    /// Interface for maze generation algorithms\n    /// \n    public interface IMazeGenerator\n    {\n        /// \n        /// Creates a new maze with the specified dimensions\n        /// \n        /// Width of the maze\n        /// Height of the maze\n        /// A 2D array representing the maze\n        bool[,] Generate(int width, int height);\n        \n        /// \n        /// Gets the name of the algorithm used for maze generation\n        /// \n        string AlgorithmName { get; }\n    }\n}"
}

The result is the actual JSON response from the MCP server:

• The interface definition is a single string value
• All newlines are escaped as \n
• All double quotes are escaped as \"
• The content is inside the result property as a JSON string

This is how an agent receives the interface definition from the MCP server. The agent then parses and displays it in a readable format for the user.

SearchPackages Example

User Query Example

A user might ask:

> "I need a library for working with JSON in my .NET application. Can you help me find the most popular packages for JSON handling?"

The agent would use the MCP server to search for packages:

Request:

{
  "name": "SearchPackages",
  "parameters": {
    "query": "JSON serialization library",
    "maxResults": 5,
    "fuzzySearch": false
  }
}

Fuzzy Search Example

For better results with descriptive queries, enable fuzzy search:

Request:

{
  "name": "SearchPackages",
  "parameters": {
    "query": "I need a library for generating mazes",
    "maxResults": 10,
    "fuzzySearch": true
  }
}

Russian Language Support Example

The AI can work with queries in Russian as well:

Request:

{
  "name": "SearchPackages",
  "parameters": {
    "query": "Пользователю надо генерировать лабиринт",
    "maxResults": 10,
    "fuzzySearch": true
  }
}

Response (formatted result shows combined results):

/* NUGET PACKAGE SEARCH RESULTS FOR: Пользователю надо генерировать лабиринт */
/* AI-GENERATED PACKAGE NAMES: MazeGenerator MazeBuilder MazeCreator */
/* FOUND 8 PACKAGES (SHOWING TOP 8) */

## DimonSmart.MazeGenerator v1.0.0
**Downloads**: 12,543
**Description**: Advanced maze generation library with multiple algorithms
**Project URL**: https://github.com/DimonSmart/MazeGenerator

## MazeBuilder v2.1.0
**Downloads**: 8,234
**Description**: Simple maze construction toolkit

How Fuzzy Search Works

The search algorithm works as follows:

• Standard search mode (fuzzySearch=false): Uses only the original query terms
• Fuzzy search mode (fuzzySearch=true):
  1. Performs standard search with original query
  2. Uses AI to analyze the functional requirements and generate 3 most likely package names
  3. AI considers common .NET package naming patterns (e.g., "maze generation" → "MazeGenerator MazeBuilder MazeCreator")
  4. Searches for AI-generated package names
  5. Combines results, removes duplicates, and sorts by popularity
  6. Combines and deduplicates results, sorted by popularity

Technical Details

The application uses the ModelContextProtocol library (version 0.2.0-preview.1), which helps create MCP-compatible servers. The server uses standard input/output to talk to clients.

Project namespaces:

• NugetMcpServer - Main namespace (used in TimeTool.cs)
• NuGetMcpServer.Tools - Tool components (interface and enum tools)
• NuGetMcpServer.Services - Service components (package and formatting services)
• NuGetMcpServer.Common - Shared components
• NuGetMcpServer.Extensions - Extension methods

Integration with Development Tools

You can use this MCP server with different development tools and AI assistants:

• VS Code: Integrate through MCP server configuration
• OllamaChat: Works with OllamaChat for local AI conversations
• GitHub Copilot: Use as an MCP server to get accurate package information
• Other MCP Clients: Any tool that supports the Model Context Protocol

By using this server, developers and AI systems get real-time, accurate information about NuGet package interfaces and enums. This reduces the chance of outdated or wrong API suggestions.

Benefits for AI Development

Reducing LLM Hallucinations

This MCP server helps solve a big problem in AI-assisted development: LLM hallucinations about package APIs. Common issues are:

• Outdated Information: LLMs trained on old data may suggest removed methods or interfaces
• Non-existent APIs: Models may generate method signatures that do not exist
• Version Mismatches: Suggestions may be for a different package version than the one used
• Incomplete Information: Missing important parameters, return types, or constraints

How NugetMcpServer Helps

• Real-time Data: Gets current interface definitions directly from NuGet packages
• Version-specific Information: Lets you query specific package versions for accurate compatibility
• Complete Interface Definitions: Gives full method signatures, properties, and generic constraints
• Accurate Type Information: Ensures correct parameter types, return types, and namespace information

Use Cases

• Package Discovery: Search for packages by functionality description and see popularity metrics
• API Discovery: See what interfaces are in a package before using it
• Version Migration: Compare interfaces between package versions when upgrading
• Code Generation: Generate accurate code from real package interfaces
• Documentation: Get up-to-date interface documentation for development
• Technology Research: Find the most popular packages for specific technologies or patterns

About the MCP Protocol

Model Context Protocol (MCP) is a protocol that standardizes communication between language models and external tools. It lets models call functions, get information, and interact with external systems through one interface.

License

Unlicense - This is free and unencumbered software released into the public domain.