Yandex MCP

MCP Server for Yandex Cloud services with Protocol Buffers support.

Features

• Full Protocol Buffers support for Yandex Cloud API
• gRPC communication
• Multiple Yandex Cloud services integration
• Type-safe TypeScript implementation
• Model Context Protocol (MCP) compatibility

Installation

npm install
npm run build

Configuration

Set the following environment variables:

export YANDEX_CLOUD_API_KEY=your_api_key
export YANDEX_IAM_TOKEN=your_iam_token  # Alternative to API key
export YANDEX_FOLDER_ID=your_folder_id
export YANDEX_CLOUD_ID=your_cloud_id

Usage

As MCP Server

npm start

Development Mode

npm run dev

Supported Services

Compute Services

• Compute Cloud: Virtual machines, disks, images, snapshots
• Instance Groups: Managed instance groups with autoscaling

Networking Services

• VPC: Virtual networks, subnets, route tables, security groups
• Load Balancer: Application and network load balancers
• DNS: Cloud DNS zones and records

Storage Services

• Object Storage: S3-compatible object storage with buckets, objects, lifecycle policies
• Disk Storage: Persistent disks for compute instances

Database Services

• Managed PostgreSQL: Fully managed PostgreSQL clusters
• Managed MySQL: Fully managed MySQL clusters
• Managed MongoDB: Fully managed MongoDB clusters
• Managed Redis: In-memory caching service
• Managed ClickHouse: Analytical database service

AI & ML Services

• YandexGPT: Large language models for text generation
• SpeechKit: Speech-to-text and text-to-speech services
• Translate: Machine translation service
• Vision: Computer vision and image analysis
• DataSphere: ML development platform

Container Services

• Managed Kubernetes: Kubernetes clusters and node groups
• Container Registry: Docker container registry with vulnerability scanning

Serverless Services

• Cloud Functions: Function-as-a-Service platform
• API Gateway: RESTful API management
• Triggers: Event-driven serverless triggers
• Serverless Containers: Containerized serverless applications

Security Services

• Certificate Manager: TLS/SSL certificate management
• KMS: Key Management Service for encryption
• Lockbox: Secrets management service
• IAM: Identity and access management

Monitoring & Operations

• Monitoring: Metrics collection and alerting
• Logging: Centralized log management
• Audit Trails: Resource access auditing

API Methods Coverage

This implementation covers ~42% of all Yandex Cloud API methods based on official protobuf definitions.

Summary by Service Category

| Category | Services | Methods Implemented | Coverage | |----------|----------|-------------------|----------| | Infrastructure | Compute, VPC | 20/80+ | 25% | | Storage | Object Storage | 25/50+ | 50% |
| Databases | PostgreSQL, MySQL, MongoDB, Redis, ClickHouse | 90/165+ | 55% | | AI/ML | YandexGPT, SpeechKit, Translate, Vision, DataSphere | 27/70+ | 39% | | Containers | Kubernetes, Container Registry | 28/55+ | 51% | | Serverless | Functions, API Gateway, Triggers | 9/47+ | 19% | | Security | KMS, Certificates, Secrets, IAM | 46/90+ | 51% |

MCP Tools Available

The server provides 25+ MCP tools for Claude integration:

Core Infrastructure

• yandex_compute_* - Virtual machine management (8 tools)
• yandex_vpc_* - Network infrastructure (4 tools)
• yandex_storage_* - Object storage operations (3 tools)

Databases

• yandex_postgres_* - PostgreSQL cluster management (2 tools)
• Additional database services available via API

AI Services

• yandex_ai_chat_complete - YandexGPT text generation
• yandex_ai_translate_text - Machine translation
• yandex_ai_synthesize_speech - Text-to-speech

Container & Serverless

• yandex_k8s_* - Kubernetes cluster management (2 tools)
• yandex_serverless_* - Cloud Functions (2 tools)

Security

• yandex_security_* - Encryption, certificates, secrets (4 tools)

📋 Detailed Coverage: See API_COVERAGE.md for complete method-by-method breakdown

Protocol Buffers

The project uses official Yandex Cloud API protobuf definitions from yandex-cloud/cloudapi.

To regenerate TypeScript definitions:

npm run proto:generate

All implemented methods are based on official protobuf schemas ensuring compatibility with both REST and gRPC APIs.

Contributing

Contributions welcome! Priority areas for expansion:

• Load Balancer services
• DNS management
• Monitoring and alerting
• Additional MCP tool implementations

License

MIT