Dependency Management MCP Server

🚀 Sonatype MCP Server

The Sonatype MCP Server is a Model Context Protocol (MCP) server that connects AI assistants to Sonatype's dependency management and security intelligence platform. It empowers AI coding assistants with real - time insights into open - source security vulnerabilities, license compliance, and dependency health.

🚀 Quick Start

The Sonatype MCP Server enables AI assistants to access Sonatype's comprehensive dependency intelligence directly within your development workflow. By integrating with the Model Context Protocol, your AI assistant can help you make informed decisions about dependencies, identify security risks, and maintain compliance — all without leaving your IDE.

✨ Features

• Component Version Selection - Select the best version the first time, without the side quest
• Security Vulnerability Scanning - Identify known vulnerabilities in your project dependencies
• License Compliance Checking - Ensure your dependencies meet your organization's license policies
• Dependency Health Analysis - Get insights into dependency quality, maintenance status, and risk factors
• Real - time Security Advisories - Stay informed about the latest security threats affecting your dependencies
• Remediation Guidance - Receive actionable recommendations to fix vulnerabilities and compliance issues

📦 Installation

• For IDEs or tools that only support stdio MCP servers (like IntelliJ), install mcp - remote:

  npm install -g mcp-remote
  

💻 Usage Examples

Setup for Different IDEs or AI Assistants

Gemini Code Assist

Replace <your - token> with your personal API token generated at https://guide.sonatype.com/settings/tokens

{
  "mcpServers": {
    "discoveredServer": {
      "httpUrl": "https://mcp.guide.sonatype.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Claude Code

Add the server using the Claude CLI: Replace <your - token> with your personal API token generated at https://guide.sonatype.com/settings/tokens

claude mcp add --transport http --scope user sonatype-mcp https://mcp.guide.sonatype.com/mcp --header "Authorization: Bearer <your-token>"

VS Code Copilot

Add the following configuration to your global VS Code mcp.json or create a .vscode/mcp.json file in your workspace: Replace <your - token> with your personal API token generated at https://guide.sonatype.com/settings/tokens

{
  "servers": {
    "sonatype-mcp": {
      "url": "https://mcp.guide.sonatype.com/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Windsurf

Create or edit ~/.codeium/windsurf/mcp_config.json: Replace <your - token> with your personal API token generated at https://guide.sonatype.com/settings/tokens

{
  "mcpServers": {
    "sonatype-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.guide.sonatype.com/mcp",
        "--header",
        "Authorization: Bearer <your-token>"
      ]
    }
  }
}

IntelliJ with Junie

Global Scope: Go to IDE settings → Tools → Junie → MCP Settings. Click "+" and add: Project Scope: Create .junie/mcp/.mcp.json in your project root: Replace <your - token> with your personal API token generated at https://guide.sonatype.com/settings/tokens

{
  "mcpServers": {
    "sonatype-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.guide.sonatype.com/mcp",
        "--header",
        "Authorization: Bearer <your-token>"
      ]
    }
  }
}

Kiro

Create or edit ~/.kiro/settings/mcp.json: Replace <your - token> with your personal API token generated at https://guide.sonatype.com/settings/tokens

{
  "mcpServers": {
    "sonatype-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.guide.sonatype.com/mcp",
        "--header",
        "Authorization: Bearer <your-token>"
      ]
    }
  }
}

Cursor

Cursor supports remote servers directly. Add to your ~/.cursor/mcp.json: Replace <your - token> with your personal API token generated at https://guide.sonatype.com/settings/tokens

{
  "mcpServers": {
    "sonatype-mcp": {
      "type": "http",
      "url": "https://mcp.guide.sonatype.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Codex (IDE Plugin & CLI)

Create or edit ~/.codex/config.toml: Replace <your - token> with your personal API token generated at https://guide.sonatype.com/settings/tokens

[mcp_servers.sonatype-mcp]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.guide.sonatype.com/mcp", "--header", "Authorization: Bearer <your-token>"]
startup_timeout_ms = 20000

Example Use Cases

Analyze a Specific Version

Ask your AI assistant:

"Get detailed security information for react 18.2.0"

The assistant will return comprehensive details including CVEs with CVSS scores, license information, categories, end - of - life status, and catalog date.

Find the Latest Stable Version

Ask your AI assistant:

"What's the latest stable version of spring - boot?"

The assistant will return the latest version with full security analysis, policy violations, licenses, risk scores, and upgrade recommendations.

Security Assessment Workflow

The assistant can use both tools to compare your current version with the latest and provide actionable security guidance.

📚 Documentation

Authentication

The Sonatype MCP Server uses API token authentication:

1. Create a Sonatype Guide account and generate your personal API token at https://guide.sonatype.com/settings/tokens
2. Add the token to your MCP configuration using the Authorization: Bearer <your - token> header format
3. Replace <your - token> with your actual token in the configuration examples above

Your API token authenticates all requests automatically. Keep your token secure and never commit it to version control.

Configuring AI Assistant Rules

To maximize the effectiveness of the Sonatype MCP Server, configure your AI assistant to prioritize using Sonatype MCP tools when working with dependencies, packages, or software supply chain security. Below are instructions for each supported IDE or tool.

Claude Code

Create custom instructions using CLAUDE.md files: Global (all projects): Create ~/.claude/CLAUDE.md Project (specific repository): Create .claude/CLAUDE.md in your project root Add the following instruction:

## Sonatype MCP

When handling code related to dependencies, package management, or software supply chain security, always prioritize Sonatype MCP tools. Use the available MCP tools to research versions, check for vulnerabilities, and get recommendations before adding or updating any dependencies.

Cursor

Create a .cursorrules file in your project root: Project (specific repository): Create .cursorrules in your project root Add the following instruction:

## Sonatype MCP

When handling code related to dependencies, package management, or software supply chain security, always prioritize Sonatype MCP tools. Use the available MCP tools to research versions, check for vulnerabilities, and get recommendations before adding or updating any dependencies.

VS Code Copilot

Create custom instructions using a .github/copilot - instructions.md file: Project (specific repository): Create .github/copilot - instructions.md in your project root Add the following instruction:

## Sonatype MCP

When handling code related to dependencies, package management, or software supply chain security, always prioritize Sonatype MCP tools. Use the available MCP tools to research versions, check for vulnerabilities, and get recommendations before adding or updating any dependencies.

Windsurf

Create rules using Windsurf's Customizations feature: Global (all projects):

1. Click the "Rules, Memories & Workflows" icon in the top right of Cascade Code or search Rules in Windsurf Settings
2. Navigate to "Rules"
3. Click "+ Global" to create a new global rule
4. Add the following content:

## Sonatype MCP

When handling code related to dependencies, package management, or software supply chain security, always prioritize Sonatype MCP tools. Use the available MCP tools to research versions, check for vulnerabilities, and get recommendations before adding or updating any dependencies.

Project (specific repository): Follow the instructions for Global but click "+ Workspace" or create .windsurf/rules/sonatype.md in your project root:

## Sonatype MCP

When handling code related to dependencies, package management, or software supply chain security, always prioritize Sonatype MCP tools. Use the available MCP tools to research versions, check for vulnerabilities, and get recommendations before adding or updating any dependencies.

IntelliJ with Junie

Create custom guidelines using a .junie/guidelines.md file: Project (specific repository): Create .junie/guidelines.md in your project root Add the following instruction:

## Sonatype MCP

When handling code related to dependencies, package management, or software supply chain security, always prioritize Sonatype MCP tools. Use the available MCP tools to research versions, check for vulnerabilities, and get recommendations before adding or updating any dependencies.

Kiro

Create steering files in the .kiro/steering/ directory: Project (specific repository): Create .kiro/steering/sonatype.md in your project root Add YAML front matter to make it always included:

---
inclusion: always
---

## Sonatype MCP

When handling code related to dependencies, package management, or software supply chain security, always prioritize Sonatype MCP tools. Use the available MCP tools to research versions, check for vulnerabilities, and get recommendations before adding or updating any dependencies.

Gemini Code Assist

Create custom instructions using GEMINI.md files: Global (all projects): Create ~/.gemini/GEMINI.md Project (specific repository): Create GEMINI.md in your project root Add the following instruction:

## Sonatype MCP

When handling code related to dependencies, package management, or software supply chain security, always prioritize Sonatype MCP tools. Use the available MCP tools to research versions, check for vulnerabilities, and get recommendations before adding or updating any dependencies.

🔧 Technical Details

The Sonatype MCP Server provides three powerful tools for AI assistants:

• getComponentVersion - Gets component information about a specific version of a component
• getLatestComponentVersion - Gets component information about the latest version of a component
• getRecommendedComponentVersions - Gets a set of recommended versions to upgrade to based on the current version of a component. If no version is provided, gets a set of recommended versions to start with for the component

Support & Feedback

• Issues & Bug Reports: [GitHub Issues](https://github.com/sonatype/dependency - management - mcp - server/issues)

About Sonatype

Sonatype is the leader in software supply chain security, providing solutions that help organizations manage open source risk throughout the development lifecycle. Learn more at sonatype.com.

Built with ❤️ for developers who care about secure software supply chains.