Интеграция coding-агента с MCP-сервером Idea

В IntelliJ Idea (а, значит, и в OpenIDE) есть встроенный MCP-сервер. Активируется он достаточно просто и позволяет расширять стандартную функциональность command-line кодинговых агентов, таких как платный Claude Code или бесплатный, но тоже весьма неплохой Qwen Code. Преимущество CLI-агентов в том, что они работают с исходниками напрямую, держат контекст всего проекта и сами проверяют компилируемость кода. А MCP-сервер предоставляет такому агенту некоторую функциональность, которая обеспечивается средствами IDE. Поскольку IDE явно лучше заточена под работу с исходниками проекта, чем универсальные агенты, такие действия выполняются быстрее и точнее.

Заходим в настройки IDE и выбираем Settings -> Tools -> MCP Server. Там выбираем Enable MCP Server, а также выдаём разрешение на выполнение команд без явного подтверждения Run shell commands.... Это нужно для того, чтобы вызовы mcp-методов на стороне агента не прерывались. При этом мы всегда держим исходники в гите и стараемся вносить изменения дозированно. Поэтому даже если агент нагенерит что-то лишнее, мы всегда сможем откатиться через систему контроля версий.

В случае с Claude Code в этом диалоге доступна автоматическая конфигурация в один клик, поэтому ничего никуда копировать не нужно. Просто нажимаем кнопку Auto-Configure.

Но более универсальной является ручная настройка. Для этого нажимаем кнопку Copy SSE Config и вставляем конфигурацию в настройки нашего агента. Для примера рассмотрим Qwen Code, т.к. вы можете использовать его абсолютно бесплатно.

Интеграция MCP-сервера IDE в Qwen Code

Заходим в файл настроек агента ~/.qwen/settings.json. Добавляем в корень json-конфигурации новый параметр mcpServers, и в нём прописываем наш сервер, дав ему произвольное имя (в данном случае idea):

{ "security" : { ... }, "model" : { ... }, "mcpServers" : { "idea" : { "type" : "sse", "url" : "http://localhost:64342/sse", "headers" : { "IJ_MCP_SERVER_PROJECT_PATH" : null } } }, "$version" : ... }

В качестве значения этого параметра вставляем ровно то, что нам скопировалось в буфер по нажатию на кнопку в IDE.

После этих изменений запускаем Qwen Code и выполняем команду /mcp list. Если всё сделано правильно, мы должны увидеть список mcp-методов, которые добавились в контекст агента:

Configured MCP servers: 🟢 idea - Ready (20 tools) Tools: - create_new_file - execute_run_configuration - execute_terminal_command - find_files_by_glob - find_files_by_name_keyword - get_all_open_file_paths - get_file_problems - get_file_text_by_path - get_project_dependencies - get_project_modules - get_repositories - get_run_configurations - get_symbol_info - list_directory_tree - open_file_in_editor - reformat_file - rename_refactoring - replace_text_in_file - search_in_files_by_regex - search_in_files_by_text

Как видите, имена методов отражают стандартную функциональность IDE. Причём здесь есть методы не только на чтение данных, но и на изменение.

Расширение набора mcp-методов от Amplicode

Amplicode - это плагин для IntelliJ Idea (и OpenIDE), который привносит много удобных функций, связанных с разработкой на Java, Kotlin и Spring. По сути этот плагин позволяет получить из "голого" Community Edition версию, близкую по функциональности к Ultimate.

Среди прочих полезных вещей в этом плагине хочу упомянуть удобную навигацию по Spring-бинам. Также доступно отдельное окно Amplicode Explorer, где будут сгруппированы все абстракции, специфичные для Spring (эндпоинты, события, конфигурации, источники данных и даже роли Spring Security).

Но разработчики плагина пошли ещё дальше, и всю эту функциональность обернули в mcp-методы, тем самым расширив в два раза набор стандартных методов, который доступны в Idea "из коробки"! Если ваш агент уже интегрирован с Idea MCP Server, то после активации плагина Amplicode команда /mcp list покажет следующий список:

🟢 idea - Ready (43 tools) Tools: - create_migration_script - create_new_file - execute_run_configuration - execute_terminal_command - find_files_by_glob - find_files_by_name_keyword - get_all_open_file_paths - get_bean_injection_info - get_endpoint_info - get_entity_details - get_file_problems - get_file_text_by_path - get_project_dependencies - get_project_modules - get_project_summary - get_properties_values - get_repositories - get_run_configurations - get_symbol_info - list_all_domain_entities - list_application_properties_files - list_connekt_files - list_db_migration_files - list_directory_tree - list_docker_compose_files - list_entity_dtos_mappers - list_entity_repositories - list_kafka_consumers - list_kafka_producers - list_module_dependencies - list_project_endpoints - list_security_configurations - list_spring_beans_tool - list_spring_profiles - list_spring_security_roles - list_test_files - open_file_in_editor - reformat_file - refresh_build_system_model - rename_refactoring - replace_text_in_file - search_in_files_by_regex - search_in_files_by_text

Здесь появилась целая группа list-методов, которая по сути повторяет функционал Amplicode Explorer. И эти методы значительно облегчают работу агента, поскольку ему уже не требуется самому парсить исходники, а достаточно вызвать нужные методы и собрать верхнеуровневую информацию о структуре проекта.

Для примера попросите агента перечислить список всех rest-эндпоинтов вашего проекта и вы увидите, как быстро и лаконично агент с этим справится благодаря MCP-методам. Чтобы не подтверждать вручную каждое действие агента, переведите его в YOLO mode (Shift+Tab).