tangcent/maven-indexer-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

23 stars 4 forks Качество 85 Тренд 30ISC

MCP-сервер, который индексирует локальные кэши Maven и Gradle, чтобы агенты ИИ могли искать классы, реализации, сигнатуры методов и исходный код из внутренних / частных зависимостей Java.

Обзор

Сервер MCP и CLI, который индексирует локальный репозиторий Maven (~/.m2/repository) и кэш Gradle (~/.gradle/caches/modules-2/files-2.1), чтобы предоставить агентам ИИ инструменты для поиска классов Java, сигнатур методов и исходного кода - даже для внутренних пакетов компании и неизвестных публичных библиотек. Добавьте следующую конфигурацию к клиенту MCP: Это позволит автоматически загружать и запускать последнюю версию сервера. Он автоматически определит местоположение вашего хранилища Maven (обычно ~/.m2/repository) и кэш Gradle. После обновления агенты, которые называют старые имена, получают «инструмент не найден», пока вы не вернетесь: Или перечислите те, которые вам нужны: MAVEN INDEXER MCP TOOLS=search,get class,callers. Все остальное остается неизменным — опубликованное название пакета по-прежнему maven-indexer-mcp (репозиторий был переименован в maven-index), а CLI проходит через maven-indexer-cli бинарный. Установить глобально для прямого использования терминала: Затем используйте maven-indexer-cli.

Обзор (машинный перевод)

Сервер MCP и CLI, который индексирует локальное хранилище Maven ([T0]) и кэш Gradle ~/.gradle/caches/modules-2/files-2.1 для предоставления агентам ИИ инструментов для поиска классов Java, сигнатур методов; исходный код — даже для внутренних корпоративных пакетов и неизвестных публичных библиотек.

Быстрая установка

Существует два способа предоставления агенту доступа к индексу. Выберите один или используйте оба:

CLI + Agent Skill: для терминальных кодирующих агентов (Claude Code, Codex, Gemini CLI, OpenCode, Cursor). При этом человек, обладающий навыками [Т2], руководствуется навыками [Т3]. Никаких схем инструментов Сидите в контекстном окне, поэтому он использует меньше токенов. MCP-сервер: для IDE-интегрированных агентов (Cursor, Kiro, Windsurf, JetBrains, …). См. MCP сервер.

CLI + Агентский навык

####Сценарий установки (рекомендуется)

Для каждого из них (в т.ч. и в т.п.) используется один (в т.ч. и т.п.). Агент, который он обнаруживает:

Требуется Node.js 18+ и npm. Варианты пропуска после bash -s --:

Опция | Значение | [скрыто] [скрыто] --target auto [[Обнаруженные агенты, по умолчанию]] all, или csv claude, agents, cursor (см. справочники навыков).

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Maven Index

An MCP server and CLI 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 — even for internal company packages and non-well-known public libraries.

Quick Install

There are two ways to give an agent access to the index. Pick one, or use both:

CLI + Agent Skill: for terminal coding agents (Claude Code, Codex, Gemini CLI, OpenCode, Cursor). The agent runs maven-indexer-cli commands, guided by the maven-indexer skill. No tool schemas sit in the context window, so it uses fewer tokens.
MCP server: for IDE-integrated agents (Cursor, Kiro, Windsurf, JetBrains, …). See MCP server.

CLI + Agent Skill

Install script (recommended)

One command installs maven-indexer-cli from npm and the maven-indexer skill for every coding agent it detects:

curl -fsSL https://raw.githubusercontent.com/tangcent/maven-indexer-mcp/main/install.sh | bash

Requires Node.js 18+ and npm. Pass options after bash -s --:

curl -fsSL https://raw.githubusercontent.com/tangcent/maven-indexer-mcp/main/install.sh | bash -s -- --target claude,agents --index

Option	Meaning
`--target`	Which agents get the skill: `auto` (detected agents, default), `all`, or a csv of `claude`, `agents`, `cursor` (see the skill directories).
`--location`	`global` (home directory, default) or `local` (current project).
`--dir`	Install the skill into this skills directory instead.
`--version`	`maven-indexer-cli` version to install (default `latest`).
`--skip-cli` / `--skip-skills`	Install only the skill / only the CLI.
`--index`	Build the index right after installing.

Re-running the script upgrades both the CLI and the skill. Restart your agent (or start a new session) afterwards so it loads the skill.

Manual install: maven-indexer-cli

npm install -g maven-indexer-cli
maven-indexer-cli refresh-index   # build the index once; later runs use `maven-indexer-cli sync`

Or run it without installing: npx -y maven-indexer-cli .

Install the skill with maven-indexer-cli

Once the CLI is installed, it can install the skill it ships with:

maven-indexer-cli skills install                          # every detected agent, global

Открыть полный README на GitHub

Установка

npx -y maven-indexer-mcp@latest

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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