Maven Indexer MCP Server

A Model Context Protocol (MCP) server that indexes your local Maven repository (~/.m2/repository) and Gradle cache (
~/.gradle/caches/modules-2/files-2.1) to provide AI agents with tools to search for Java classes, method signatures,
and source code.

Key Use Case: While AI models are well-versed in popular public libraries (like Spring, Apache Commons, Guava), they
often struggle with:

1. Internal Company Packages: Private libraries that are not public.
2. Non-Well-Known Public Packages: Niche or less popular open-source libraries.

This server bridges that gap by allowing the AI to "read" your local dependencies, effectively giving it knowledge of
your private and obscure libraries.

Features

Semantic Class Search: Search for classes by name or purpose.
Inheritance Search: Find all implementations of an interface or subclasses of a class.
On-Demand Analysis: Extracts method signatures and Javadocs directly from JARs.
Source Code Retrieval: Provides full source code if available.
Real-time Monitoring: Automatically updates the index when repositories change.

{
  "mcpServers": {
    "maven-indexer": {
      "command": "npx",
      "args": [
        "-y",
        "maven-indexer-mcp@latest"
      ]
    }
  }
}

Find the class StringUtils in my local maven repository and show me its methods.

MAVEN_REPO: Absolute path to your local Maven repository (e.g., /Users/yourname/.m2/repository). Use this if
your repository is in a non-standard location.
GRADLE_REPO_PATH: Absolute path to your Gradle cache (e.g.,
/Users/yourname/.gradle/caches/modules-2/files-2.1).
INCLUDED_PACKAGES: Comma-separated list of package patterns to index (e.g., com.mycompany.,org.example.).
Default is (index everything).
MAVEN_INDEXER_CFR_PATH: (Optional) Absolute path to a specific CFR decompiler JAR. If not provided, the server
will attempt to use its bundled CFR version.

Example with optional configuration:

{
  "mcpServers": {
    "maven-indexer": {
      "command": "npx",
      "args": [
        "-y",
        "maven-indexer-mcp@latest"
      ],
      "env": {
        "MAVEN_REPO": "/Users/yourname/.m2/repository",
        "GRADLE_REPO_PATH": "/Users/yourname/.gradle/caches/modules-2/files-2.1",
        "INCLUDED_PACKAGES": "com.mycompany.",
        "MAVEN_INDEXER_CFR_PATH": "/path/to/cfr-0.152.jar"
      }
    }
  }
}

    git clone https://github.com/tangcent/maven-indexer-mcp.git
    cd maven-indexer-mcp
    

    npm install
    npm run build
    

    {
      "mcpServers": {
        "maven-indexer": {
          "command": "node",
          "args": ["/absolute/path/to/maven-indexer-mcp/build/index.js"]
        }
      }
    }
    

search_classes: Search for Java classes in the local Maven repository and Gradle caches.
WHEN TO USE:
1. Internal/Private Code: You need to find a class from a company-internal library.
2. Obscure Libraries: You are using a less common public library that the AI doesn't know well.
3. Version Verification: You need to check exactly which version of a class is present locally.

Note: For well-known libraries (e.g., standard Java lib, Spring), the AI likely knows the class structure
already, so this tool is less critical.
Examples: "Show me the source of StringUtils", "What methods are available on DateTimeUtils?", "Where is this
class imported from?".
Input: className (e.g., "StringUtils", "Json parser")
Output: List of matching classes with their artifacts.
get_class_details: Decompile and read the source code of external libraries/dependencies. Use this instead
of 'SearchCodebase' for classes that are imported but defined in JAR files.
Key Value: "Don't guess what the internal library does—read the code."
Tip: Essential for internal/proprietary code where documentation is scarce or non-existent.
Input: className (required), artifactId (optional), type ("signatures", "docs", "source")
Output: Method signatures, Javadocs, or full source code.
Note: If artifactId is omitted, the tool automatically selects the best available artifact (preferring those
with source code attached).
search_artifacts: Search for artifacts in Maven/Gradle caches by coordinate (groupId, artifactId).
search_implementations: Search for classes that implement a specific interface or extend a specific class.
Useful for finding SPI implementations in external libraries.
Input: className (e.g. "java.util.List")
Output: List of implementation/subclass names and their artifacts.
refresh_index: Trigger a re-scan of the Maven repository.

Development

Run tests: npm test
Watch mode: npm run watch

License

ISC