NuGet Packages MCP Server

A Model Context Protocol (MCP) server that provides tools for searching and retrieving NuGet package information. This server enables AI assistants to interact with NuGet package repositories through standardized MCP tools.

Overview

The NuGet Packages MCP Server is a .NET-based implementation that exposes NuGet package metadata retrieval capabilities through the MCP protocol. It allows AI assistants to:

• Retrieve all available versions of a NuGet package
• Analyze package dependencies for specific versions
• Extract and document public API contracts from packages
• Access package information from any NuGet v3 feed

Features

• Version Discovery: Get all available versions of a package including prerelease versions
• Dependency Analysis: View package dependencies and their version requirements for specific package versions
• API Contract Extraction: Generate markdown documentation of public interfaces and classes from packages
• Package Metadata: Access detailed package information including authors, license, tags, and project URLs
• Flexible Feed Support: Configure to use any NuGet v3 compatible feed (default: nuget.org)
• MCP Protocol Compliance: Full support for MCP tool schemas and communication

Prerequisites

• .NET 8.0 SDK or later
• Node.js (for running the MCP Inspector)
• An MCP-compatible client (e.g., Claude Desktop, Cline VS Code extension)

Installation

1. Clone the repository:

   git clone https://github.com/oshvartz/nuget-packages-mcp-server.git
   cd nuget-packages-mcp-server
   

2. Build the project:

   dotnet build -c Release
   

3. The built DLL will be located at:

   src/NugetPackagesMcpServer/bin/Release/net8.0/NugetPackagesMcpServer.dll
   

Configuration

Adding to MCP Settings

Add the following configuration to your MCP client settings (e.g., cline_mcp_settings.json):

{
  "nuget-packages-mcp-server": {
    "disabled": false,
    "timeout": 300,
    "command": "dotnet",
    "args": [
      "C:/path/to/NugetPackagesMcpServer.dll"
    ],
    "env": {
      "NugetFeed:FeedUrl": "https://api.nuget.org/v3/index.json"
    },
    "type": "stdio"
  }
}

Configuration Options

• timeout: Maximum time (in seconds) for server operations
• NugetFeed:FeedUrl: The NuGet v3 feed URL to use (defaults to nuget.org)

Available Tools

The server provides the following MCP tools:

GetPackageVersions

Get all available versions of a NuGet package from the configured feed.

Parameters:

• packageName (string, required): The name of the NuGet package
• includePrerelease (boolean, optional): Include prerelease versions in results (defaults to feed configuration)

GetPackageDependencies

Get package dependencies for a specific package name and version.

Parameters:

• packageName (string, required): The name of the NuGet package
• version (string, required): The specific version of the package

GetPackageContracts

Get public interfaces and classes contracts from a NuGet package as markdown. This tool extracts and documents the public API surface of a package.

Parameters:

• packageName (string, required): The name of the NuGet package
• version (string, required): The specific version of the package

Returns: A markdown document containing:

• Package metadata (description, authors, tags, license, project URL)
• Public interfaces and classes with their members
• Method signatures and documentation

Testing with MCP Inspector

The repository includes a PowerShell script (test-mcp-inspector.ps1) that uses the official MCP Inspector tool to test and debug the server.

What is MCP Inspector?

MCP Inspector is an official debugging tool from the Model Context Protocol team that provides:

• A web-based interface for testing MCP servers
• Interactive tool invocation and response inspection
• Schema validation and protocol compliance checking
• Rea

... View full README on GitHub