Vertex AI MCP Server
Сервер Vertex AI MCP
В этом проекте реализован сервер Model Context Protocol (MCP), который предоставляет комплексный набор инструментов для взаимодействия с моделями Vertex AI Gemini от Google Cloud, уделяя особое внимание помощи в кодировании и ответам на общие запросы.
Функции
Предоставляет доступ к моделям Vertex AI Gemini через многочисленные инструменты MCP.
Поддерживает обоснование веб-поиска (
answer_query_websearch) и ответы на основе прямых знаний (answer_query_direct).Настраиваемый идентификатор модели, температура, поведение потоковой передачи, максимальное количество выходных токенов и параметры повтора с помощью переменных среды.
По умолчанию используется потоковый API для потенциально лучшего отклика.
Включает базовую логику повторных попыток для временных ошибок API.
Применяются минимальные фильтры безопасности (
BLOCK_NONE) для снижения потенциальной блокировки (используйте с осторожностью).
Related MCP server: MCP with Gemini Integration
Предоставляемые инструменты
Запрос и генерация (с упором на ИИ)
answer_query_websearch: отвечает на запросы на естественном языке, используя настроенную модель Vertex AI, улучшенную с помощью результатов поиска Google.answer_query_direct: отвечает на запрос на естественном языке, используя только внутренние знания настроенной модели Vertex AI.explain_topic_with_docs: предоставляет подробное объяснение запроса по определенной теме программного обеспечения, синтезируя информацию, в основном из официальной документации, найденной с помощью веб-поиска.get_doc_snippets: предоставляет точные, достоверные фрагменты кода или краткие ответы на технические вопросы путем поиска в официальной документации.generate_project_guidelines: создает структурированный документ с рекомендациями по проекту (Markdown) на основе указанного списка технологий (опционально с версиями), используя веб-поиск передового опыта.
Инструменты исследования и анализа
code_analysis_with_docs: анализирует фрагменты кода, сравнивая их с лучшими практиками из официальной документации, выявляя потенциальные ошибки, проблемы с производительностью и уязвимости безопасности.technical_comparison: сравнивает несколько технологий, фреймворков или библиотек на основе определенных критериев, предоставляя подробные сравнительные таблицы с плюсами/минусами и вариантами использования.architecture_pattern_recommendation: предлагает шаблоны архитектуры для конкретных вариантов использования на основе лучших отраслевых практик с примерами реализации и соображениями.dependency_vulnerability_scan: анализирует зависимости проекта на предмет известных уязвимостей безопасности, предоставляя подробную информацию и стратегии смягчения последствий.database_schema_analyzer: проверяет схемы баз данных на предмет нормализации, индексации и проблем производительности, предлагая улучшения на основе передового опыта, специфичного для конкретной базы данных.security_best_practices_advisor: предоставляет рекомендации по безопасности для конкретных технологий или сценариев, а также примеры кода для внедрения безопасных практик.testing_strategy_generator: создает комплексные стратегии тестирования для приложений или функций, предлагая соответствующие типы тестирования с целями покрытия.regulatory_compliance_advisor: предоставляет рекомендации по нормативным требованиям для конкретных отраслей (GDPR, HIPAA и т. д.) с подходами к внедрению для обеспечения соответствия.microservice_design_assistant: помогает проектировать архитектуры микросервисов для определенных доменов с рекомендациями по границам сервисов и шаблонами коммуникации.documentation_generator: создает исчерпывающую документацию по коду, API или системам, следуя лучшим отраслевым практикам технической документации.
Операции файловой системы
read_file_content: Прочитать полное содержимое одного или нескольких файлов. Укажите одну строку пути или массив строк пути.write_file_content: Создать новые файлы или полностью перезаписать существующие файлы. Аргумент 'writes' принимает один объект ({path, content}) или массив таких объектов.edit_file_content: вносит построчные изменения в текстовый файл, возвращает предварительный просмотр различий или применяет изменения.list_directory_contents: выводит список файлов и каталогов непосредственно по указанному пути (нерекурсивно).get_directory_tree: Получает рекурсивное древовидное представление файлов и каталогов в формате JSON.move_file_or_directory: Перемещает или переименовывает файлы и каталоги.search_filesystem: Рекурсивный поиск файлов/каталогов, соответствующих шаблону имени, с возможными исключениями.get_filesystem_info: Извлекает подробные метаданные (размер, даты, тип, разрешения) о файле или каталоге.execute_terminal_command: Выполнить команду оболочки, при необходимости указавcwdиtimeout. Возвращает stdout/stderr.
Комбинированные операции ИИ + файловой системы
save_generate_project_guidelines: создает руководства по проекту на основе технологического стека и сохраняет результат в указанном файле.save_doc_snippet: находит фрагменты кода из документации и сохраняет результат в указанном файле.save_topic_explanation: создает подробное объяснение темы на основе документации и сохраняет результат в указанном файле.save_answer_query_direct: отвечает на запрос, используя только внутренние знания, и сохраняет ответ в указанном файле.save_answer_query_websearch: отвечает на запрос, используя результаты веб-поиска, и сохраняет ответ в указанном пути к файлу.
(Примечание: схемы ввода/вывода для каждого инструмента определены в соответствующих файлах в src/tools/ и предоставляются через сервер MCP.)
Предпосылки
Node.js (v18+)
Бан (
npm install -g bun)Проект Google Cloud с включенным биллингом.
API Vertex AI включен в проект GCP.
В вашей среде настроена аутентификация Google Cloud (рекомендуется использовать учетные данные приложения по умолчанию с помощью
gcloud auth application-default loginили ключ учетной записи службы).
Настройка и установка
Клонировать/разместить проект: убедитесь, что файлы проекта находятся в нужном вам месте.
Установить зависимости:
bun installНастроить среду:
Создайте файл
.envв корне проекта (скопируйте.env.example).Задайте обязательные и необязательные переменные среды, как описано в
.env.example.Установите
AI_PROVIDERна"vertex"или"gemini".Если
AI_PROVIDER="vertex", требуетсяGOOGLE_CLOUD_PROJECT.Если
AI_PROVIDER="gemini", требуетсяGEMINI_API_KEY.
Сборка сервера:
bun run buildЭто компилирует код TypeScript в
build/index.js.
Использование (автономное / NPX)
После публикации в npm вы можете запустить этот сервер напрямую с помощью npx :
# Ensure required environment variables are set (e.g., GOOGLE_CLOUD_PROJECT)
bunx vertex-ai-mcp-serverЛибо установите его глобально:
bun install -g vertex-ai-mcp-server
# Then run:
vertex-ai-mcp-serverПримечание: для автономного запуска требуется настроить необходимые переменные среды (например, GOOGLE_CLOUD_PROJECT , GOOGLE_CLOUD_LOCATION , учетные данные аутентификации, если не используется ADC) в среде оболочки перед выполнением команды.
Установка через Smithery
Чтобы автоматически установить Vertex AI Server для Claude Desktop через Smithery :
bunx -y @smithery/cli install @shariqriazz/vertex-ai-mcp-server --client claudeБег с Клайном
Настройте параметры MCP: добавьте/обновите конфигурацию в файле настроек Cline MCP (например,
.roo/mcp.json). У вас есть два основных способа настроить команду:Вариант A: использование Node (прямой путь — рекомендуется для разработки)
Этот метод использует
nodeдля прямого запуска скомпилированного скрипта. Это полезно во время разработки, когда у вас есть код, клонированный локально.{ "mcpServers": { "vertex-ai-mcp-server": { "command": "node", "args": [ "/full/path/to/your/vertex-ai-mcp-server/build/index.js" // Use absolute path or ensure it's relative to where Cline runs node ], "env": { // --- General AI Configuration --- "AI_PROVIDER": "vertex", // "vertex" or "gemini" // --- Required (Conditional) --- "GOOGLE_CLOUD_PROJECT": "YOUR_GCP_PROJECT_ID", // Required if AI_PROVIDER="vertex" // "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY", // Required if AI_PROVIDER="gemini" // --- Optional Model Selection --- "VERTEX_MODEL_ID": "gemini-2.5-pro-exp-03-25", // If AI_PROVIDER="vertex" (Example override) "GEMINI_MODEL_ID": "gemini-2.5-pro-exp-03-25", // If AI_PROVIDER="gemini" // --- Optional AI Parameters --- "GOOGLE_CLOUD_LOCATION": "us-central1", // Specific to Vertex AI "AI_TEMPERATURE": "0.0", "AI_USE_STREAMING": "true", "AI_MAX_OUTPUT_TOKENS": "65536", // Default from .env.example "AI_MAX_RETRIES": "3", "AI_RETRY_DELAY_MS": "1000", // --- Optional Vertex Authentication --- // "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account-key.json" // If using Service Account Key for Vertex }, "disabled": false, "alwaysAllow": [ // Add tool names here if you don't want confirmation prompts // e.g., "answer_query_websearch" ], "timeout": 3600 // Optional: Timeout in seconds } // Add other servers here... } }Важно: Убедитесь, что путь
argsправильно указывает на файлbuild/index.js. Использование абсолютного пути может быть более надежным.
Вариант B: использование NPX (требуется публикация пакета в npm)
Этот метод использует
npxдля автоматической загрузки и запуска пакета сервера из реестра npm. Это удобно, если вы не хотите клонировать репозиторий.{ "mcpServers": { "vertex-ai-mcp-server": { "command": "bunx", // Use bunx "args": [ "-y", // Auto-confirm installation "vertex-ai-mcp-server" // The npm package name ], "env": { // --- General AI Configuration --- "AI_PROVIDER": "vertex", // "vertex" or "gemini" // --- Required (Conditional) --- "GOOGLE_CLOUD_PROJECT": "YOUR_GCP_PROJECT_ID", // Required if AI_PROVIDER="vertex" // "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY", // Required if AI_PROVIDER="gemini" // --- Optional Model Selection --- "VERTEX_MODEL_ID": "gemini-2.5-pro-exp-03-25", // If AI_PROVIDER="vertex" (Example override) "GEMINI_MODEL_ID": "gemini-2.5-pro-exp-03-25", // If AI_PROVIDER="gemini" // --- Optional AI Parameters --- "GOOGLE_CLOUD_LOCATION": "us-central1", // Specific to Vertex AI "AI_TEMPERATURE": "0.0", "AI_USE_STREAMING": "true", "AI_MAX_OUTPUT_TOKENS": "65536", // Default from .env.example "AI_MAX_RETRIES": "3", "AI_RETRY_DELAY_MS": "1000", // --- Optional Vertex Authentication --- // "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account-key.json" // If using Service Account Key for Vertex }, "disabled": false, "alwaysAllow": [ // Add tool names here if you don't want confirmation prompts // e.g., "answer_query_websearch" ], "timeout": 3600 // Optional: Timeout in seconds } // Add other servers here... } }Убедитесь, что переменные среды в блоке
envустановлены правильно, либо соответствуют.env, либо явно определены здесь. Удалите комментарии из фактического файла JSON.
Перезапуск/перезагрузка Cline: Cline должен обнаружить изменение конфигурации и запустить сервер.
Использование инструментов: теперь вы можете использовать обширный список инструментов через Cline.
Разработка
Режим просмотра:
bun run watchЛинтинг:
bun run lintФорматирование:
bun run format
Лицензия
Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .
Available Tools
20 toolsanswer_query_directA
Answers a natural language query using only the internal knowledge of the configured Vertex AI model (gemini-2.5-pro-exp-03-25). Does not use web search. Requires a 'query' string.
Inputs: query (required).
answer_query_websearchB
Answers a natural language query using the configured Vertex AI model (gemini-2.5-pro-exp-03-25) enhanced with Google Search results for up-to-date information. Requires a 'query' string.
Inputs: query (required).
create_directoryA
Create a new directory or ensure a directory exists in the workspace filesystem. Can create multiple nested directories in one operation (like mkdir -p). If the directory already exists, this operation will succeed silently. Perfect for setting up directory structures for projects.
Inputs: path (required).
edit_file_contentA
Make line-based edits to a text file in the workspace filesystem. Each edit attempts to replace an exact match of 'oldText' with 'newText'. If no exact match is found, it attempts a line-by-line match ignoring leading/trailing whitespace. Indentation of the first line is preserved, and relative indentation of subsequent lines is attempted. Returns a git-style diff showing the changes made (or previewed if dryRun is true).
Inputs: edits (required), path (required), dryRun.
explain_topic_with_docsA
Provides a detailed explanation for a query about a specific software topic by synthesizing information primarily from official documentation found via web search. Focuses on comprehensive answers, context, and adherence to documented details. Uses the configured Vertex AI model (gemini-2.5-pro-exp-03-25) with Google Search. Requires 'topic' and 'query'.
Inputs: query (required), topic (required).
generate_project_guidelinesA
Generates a structured project guidelines document (e.g., Markdown) based on a specified list of technologies and versions (tech stack). Uses web search to find the latest official documentation, style guides, and best practices for each component and synthesizes them into actionable rules and recommendations. Uses the configured Vertex AI model (gemini-2.5-pro-exp-03-25) with Google Search. Requires 'tech_stack'.
Inputs: tech_stack (required).
get_directory_treeA
Get a recursive tree view of files and directories within the workspace filesystem as a JSON structure. Each entry includes 'name', 'type' (file/directory), and 'children' (an array) for directories. Files have no 'children' array. The output is formatted JSON text. Useful for understanding the complete structure of a project directory.
Inputs: path (required).
get_doc_snippetsA
Provides precise, authoritative code snippets or concise answers for technical queries by searching official documentation. Focuses on delivering exact solutions without unnecessary explanation. Uses the configured Vertex AI model (gemini-2.5-pro-exp-03-25) with Google Search. Requires 'topic' and 'query'.
Inputs: query (required), topic (required), include_examples, version.
get_filesystem_infoA
Retrieve detailed metadata about a file or directory within the workspace filesystem. Returns comprehensive information including size (bytes), creation time, last modified time, last accessed time, type (file/directory), and permissions (octal string). This tool is perfect for understanding file characteristics without reading the actual content.
Inputs: path (required).
list_directory_contentsA
Get a detailed listing of all files and directories directly within a specified path in the workspace filesystem. Results clearly distinguish between files and directories with [FILE] and [DIR] prefixes. This tool is essential for understanding directory structure and finding specific files within a directory. Does not list recursively.
Inputs: path (required).
move_file_or_directoryA
Move or rename files and directories within the workspace filesystem. Can move items between directories and rename them in a single operation. If the destination path already exists, the operation will likely fail (OS-dependent).
Inputs: destination (required), source (required).
read_file_contentA
Read the complete contents of a file from the workspace filesystem. Handles various text encodings and provides detailed error messages if the file cannot be read. Use this tool when you need to examine the contents of a single file within the workspace.
Inputs: path (required).
read_multiple_files_contentA
Read the contents of multiple files simultaneously from the workspace filesystem. This is more efficient than reading files one by one when you need to analyze or compare multiple files. Each file's content is returned with its path as a reference. Failed reads for individual files won't stop the entire operation.
Inputs: paths (required).
save_answer_query_directA
Answers a natural language query using only the internal knowledge of the configured Vertex AI model (gemini-2.5-pro-exp-03-25), does not use web search, and saves the answer to a file. Requires 'query' and 'output_path'.
Inputs: output_path (required), query (required).
save_answer_query_websearchA
Answers a natural language query using Google Search results and saves the answer to a file. Uses the configured Vertex AI model (gemini-2.5-pro-exp-03-25). Requires 'query' and 'output_path'.
Inputs: output_path (required), query (required).
save_doc_snippetA
Provides precise code snippets or concise answers for technical queries by searching official documentation and saves the result to a file. Uses the configured Vertex AI model (gemini-2.5-pro-exp-03-25) with Google Search. Requires 'topic', 'query', and 'output_path'.
Inputs: output_path (required), query (required), topic (required), include_examples, +1 more.
save_generate_project_guidelinesA
Generates comprehensive project guidelines based on a tech stack using web search and saves the result to a specified file path. Uses the configured Vertex AI model (gemini-2.5-pro-exp-03-25). Requires 'tech_stack' and 'output_path'.
Inputs: output_path (required), tech_stack (required).
save_topic_explanationC
Provides a detailed explanation for a query about a specific software topic using official documentation found via web search and saves the result to a file. Uses the configured Vertex AI model (gemini-2.5-pro-exp-03-25). Requires 'topic', 'query', and 'output_path'.
Inputs: output_path (required), query (required), topic (required).
search_filesystemA
Recursively search for files and directories within the workspace filesystem matching a pattern in their name. Searches through all subdirectories from the starting path. The search is case-insensitive and matches partial names. Returns full paths (relative to workspace) to all matching items. Supports excluding paths using glob patterns.
Inputs: path (required), pattern (required), excludePatterns.
write_file_contentA
Create a new file or completely overwrite an existing file in the workspace filesystem with new content. Use with caution as it will overwrite existing files without warning. Handles text content with proper encoding.
Inputs: content (required), path (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
The tool set has clear distinctions between filesystem operations (e.g., create_directory, read_file_content) and AI query tools, but significant ambiguity exists within the AI query category. For example, answer_query_direct, explain_topic_with_docs, and get_doc_snippets all involve answering queries with the AI model, differing mainly in their use of web search or documentation focus, which could confuse an agent about which to select for a given task. The 'save_' variants further overlap with their non-save counterparts, adding redundancy rather than clarity.
Most tools follow a consistent verb_noun pattern (e.g., create_directory, read_file_content, search_filesystem), which is predictable and readable. However, there are minor deviations: some tools use underscores inconsistently (e.g., get_doc_snippets vs. save_doc_snippet) or have longer names (e.g., explain_topic_with_docs), and the 'save_' prefix is applied inconsistently across AI tools. Overall, the naming is mostly consistent but not perfectly uniform.
With 20 tools, the count is borderline high for a server focused on Vertex AI and filesystem operations. While the domain is broad, the tool set feels heavy due to redundant 'save_' variants and overlapping AI query tools. A more streamlined set of 10-15 tools could cover the same functionality without duplication, making this count slightly excessive but not extreme.
The server covers two main domains: filesystem management and AI-powered querying. For filesystem operations, it provides comprehensive CRUD-like coverage (create, read, edit, move, search, etc.), with no obvious gaps. For AI queries, it offers various modes (direct, web search, documentation-focused) and saving options, though the redundancy might mask minor gaps in specific query types. Overall, the surface is largely complete for its intended purposes.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
Related MCP Servers
- AlicenseAqualityDmaintenanceModel Context Protocol (MCP) server implementation that enables Claude Desktop to interact with Google's Gemini AI models.6260MIT
- FlicenseNot gradedqualityDmaintenanceImplements a Model Control Protocol server integrated with Google Gemini LLM, providing a flexible framework for building AI-powered applications.-
- FlicenseNot gradedqualityNot gradedmaintenanceModel Context Protocol server for Google Cloud Platform, enabling interaction with Resource Manager, Compute Engine, Cloud Storage, BigQuery, Pub/Sub, and Cloud Logging via natural language.3-
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that provides AI-powered Google search functionality using Gemini.1-