Maven Tools MCP

🚀 Maven Tools MCP Server

JVMビルドツール向けの汎用的なMaven Central依存関係インテリジェンスを提供します。MCPサーバーは、すべてのJVMビルドツール（Maven、Gradle、SBT、Mill）に対して、Maven Centralの依存関係情報をAIアシスタントに提供します。Maven Centralリポジトリから直接maven-metadata.xmlファイルを読み取ることで、即座に正確な依存関係情報を取得でき、ウェブ検索や検索APIよりも高速かつ信頼性が高いです。また、Context7との統合により、ドキュメントサポートも提供します。

🚀 クイックスタート

このサーバーは、MCP互換のAIアシスタントと連携して、JVMビルドツールの依存関係情報を提供します。以下の手順でセットアップしてください。

Claude Desktopのセットアップ

手順1: Claude Desktopの設定ファイルを見つけます。

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

手順2: この設定を追加します（事前にビルドされたDockerイメージを使用）。

{
  "mcpServers": {
    "maven-tools": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "-e", "SPRING_PROFILES_ACTIVE=docker",
        "arvindand/maven-tools-mcp:latest"
      ]
    }
  }
}

手順3: Claude Desktopを再起動します。

前提条件: Dockerがインストールされ、実行中であること。

注意: Dockerイメージは、AMD64（Intel/AMD）とARM64（Apple Silicon）の両方のアーキテクチャをサポートしています。Dockerは自動的にあなたのプラットフォームに適したバージョンを選択します。

VS Code with GitHub Copilotのセットアップ

オプション1: ワークスペース設定 - .vscode/mcp.jsonを作成します。

{
  "servers": {
    "maven-tools": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "SPRING_PROFILES_ACTIVE=docker", "arvindand/maven-tools-mcp:latest"]
    }
  }
}

オプション2: ユーザー設定 - VS Codeの設定に追加します。

{
  "mcp": {
    "servers": {
      "maven-tools": {
        "type": "stdio", 
        "command": "docker",
        "args": ["run", "-i", "--rm", "-e", "SPRING_PROFILES_ACTIVE=docker", "arvindand/maven-tools-mcp:latest"]
      }
    }
  }
}

使用方法: チャットビューを開き（Ctrl+Alt+I）、エージェントモードを選択し、ツールボタンを使用してMavenツールを有効にします。

✨ 主な機能

• 依存関係情報の即時取得: Maven Centralリポジトリから直接maven-metadata.xmlファイルを読み取り、即座に正確な依存関係情報を取得できます。
• バルク操作: 一度に複数の依存関係を分析できます。
• バージョン比較: 現在のバージョンと最新のバージョンを比較し、アップグレードの推奨事項を提供します。
• 依存関係の年代分析: 依存関係の新鮮さを分析し、アクション可能な洞察を提供します。
• メンテナンスパターン分析: メンテナンスパターンを分析し、次のリリースの予測を提供します。
• プロジェクトの健全性評価: プロジェクトの依存関係の健全性を評価し、推奨事項を提供します。
• Context7統合: Context7との統合により、ドキュメントガイダンスや移行ガイダンスを提供します。
• ドキュメント強化: 複雑なアップグレードに対するドキュメントを強化します。
• キャッシュ機能: キャッシュによりパフォーマンスを向上させます。

📦 インストール

Docker Composeを使用する場合

docker-compose.ymlをダウンロードし、以下のように設定します。

{
  "mcpServers": {
    "maven-tools": {
      "command": "docker",
      "args": [
        "compose", "-f", "/absolute/path/to/docker-compose.yml", 
        "run", "--rm", "maven-tools-mcp"
      ]
    }
  }
}

ソースからビルドする場合

前提条件:

• Java 24
• Maven 3.9+

# リポジトリをクローンします
git clone https://github.com/arvindand/maven-tools-mcp.git
cd maven-tools-mcp

# クイックビルド（CIに適しています - ユニットテストのみ）
./mvnw clean package -Pci

# すべてのテストを含むフルビルド（ネットワークアクセスが必要です）
./mvnw clean package -Pfull

# JARを実行します
java -jar target/maven-tools-mcp-1.4.0.jar

ビルドスクリプトを使用する場合

build/フォルダにあるスクリプトを使用して、簡単にビルドできます。

# Linux/macOS - 完全なビルドヘルパー
./build/build.sh

# Windows - 完全なビルドヘルパー
.\build\build.cmd

💻 使用例

基本的な使用法

# 最新のSpring Bootバージョンを取得するが、安定版を優先する
"Get latest Spring Boot version but prioritize stable releases"

# Kotlin 1.9.0が存在するかどうかを確認し、その安定性のタイプを確認する
"Check if Kotlin 1.9.0 exists and what stability type it is"

# 本番デプロイ用のRetrofitの最新の安定版を表示する
"Show me latest stable version of Retrofit for production deployment"

高度な使用法

# 複数の依存関係をチェックするが、安定版のみにフィルタリングする
"Check multiple dependencies but filter to stable versions only"

# 現在のバージョンを比較し、安全のためにonlyStableTargets=trueに設定する
"Compare my current versions with onlyStableTargets=true for safety"

# 完全な分析を取得するが、結果で安定版を優先する
"Get complete analysis but prefer stable versions in results"

📚 ドキュメント

利用可能なツール

コアMavenインテリジェンスツール（8つのツール）

生のContext7ドキュメントツール（2つのツール - デフォルトで有効）

ツールのパラメータ

コアパラメータ

• preferStable - 分析で安定版を優先します。
• stableOnly - 本番環境で使用可能なバージョンのみにフィルタリングします。
• onlyStableTargets - 安定版へのアップグレードのみを提案します。

分析パラメータ

• maxAgeInDays - 依存関係の許容可能な年代の閾値を設定します。
• monthsToAnalyze - リリースパターンの分析期間を指定します（デフォルト: 24）。
• versionCount - タイムラインで分析する最近のバージョンの数を指定します（デフォルト: 20）。
• includeRecommendations - 健全性分析に詳細な推奨事項を含めます。

Context7統合

Context7統合はデフォルトで有効です（context7.enabled=true）。Mavenツールは、アップグレードや近代化が必要な場合、応答モデルに明示的なオーケストレーション指示を自動的に含めます。また、サーバーはMCPクライアントとしても機能し、生のContext7ツール（resolve-library-id、get-library-docs）をAIアシスタントに直接公開します。無効にすると、応答にはオーケストレーション指示やContext7ツールを含まないコア依存関係分析のみが含まれます。

🔧 技術詳細

• フレームワーク: Spring Boot 3.5.4 with Spring AI MCP
• MCPプロトコル: 2024-11-05
• Javaバージョン: 24
• トランスポート: stdio
• HTTPクライアント: Spring Web RestClient
• キャッシュ: Caffeine（24時間のTTL、最大2000エントリ）
• データソース: Maven Central Repository（maven-metadata.xmlファイル）

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。