klogins-hash/scaleway-mcp-server

Scaleway MCP Server

A comprehensive Model Context Protocol (MCP) server for managing Scaleway cloud infrastructure. This server provides both local STDIO and HTTP-based interfaces for seamless integration with MCP clients.

🚀 Features

• Complete Scaleway API Coverage: Manage instances, databases, storage, networking, and more
• Dual Deployment Options: Local STDIO server and HTTP server for remote access
• Serverless Ready: Deploy to Scaleway Serverless Containers with one command
• MCP Protocol Compliant: Full support for MCP 2024-11-05 specification
• Production Ready: Docker containerization, health checks, and monitoring

🛠️ Available Tools

Instance Management

• list_instances - List all compute instances
• get_instance - Get detailed instance information
• start_instance - Start stopped instances
• stop_instance - Stop running instances

Kubernetes

• list_k8s_clusters - List all Kubernetes clusters

Database Management

• list_databases - List PostgreSQL, MySQL databases
• get_database - Get detailed database information

Object Storage

• list_buckets - List all S3-compatible storage buckets

Container Registry

• list_registries - List container registries and images

Load Balancers

• list_load_balancers - List all load balancers

Serverless

• list_functions - List all serverless functions
• list_containers - List all serverless containers

Redis & Networking

• list_redis_clusters - List Redis clusters
• list_private_networks - List VPCs and private networks

Marketplace

• list_marketplace_images - Browse available OS/app images

📦 Quick Start

1. Local Development

# Clone the repository
git clone <repository-url>
cd scaleway-mcp-server

# Install dependencies
uv sync

# Set up environment variables
cp .env.example .env
# Edit .env with your Scaleway credentials

# Run the STDIO server
uv run scaleway_server.py

# Or run the HTTP server
uv run scaleway_http_server.py

2. Serverless Deployment

# Configure Scaleway CLI
scw init

# Deploy to Scaleway Serverless Containers
./deploy.sh

🔧 Configuration

Environment Variables

MCP Client Configuration

For HTTP transport:

{
  "mcpServers": {
    "scaleway": {
      "transport": "http",
      "url": "https://your-deployment-url/mcp"
    }
  }
}

For STDIO transport:

{
  "mcpServers": {
    "scaleway": {
      "command": "uv",
      "args": ["run", "scaleway_server.py"],
      "cwd": "/path/to/scaleway-mcp-server"
    }
  }
}

🐳 Docker Deployment

# Build the image
docker build -t scaleway-mcp-server .

# Run locally
docker run -p 8080:8080 \
  -e SCW_ACCESS_KEY=your_access_key_here \
  -e SCW_SECRET_KEY=your_secret_key_here \
  -e SCW_PROJECT_ID=your_project_id_here \
  -e SCW_ORGANIZATION_ID=your_organization_id_here \
  scaleway-mcp-server

📚 Documentation

🔐 Security

• Never commit real credentials to version control
• Use environment variables or secure secret management
• The server validates API credentials on startup
• All API calls use official Scaleway SDK with proper authentication

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

• Check the for detailed guides
• Open an issue for bugs or feature requests
• Review the for technical details

🏗️ Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP Client    │    │  Scaleway MCP    │    │  Scaleway API   │
│   (Manus, etc)  │◄──►│     Server       │◄──►│   (Official)    │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────────┐
                       │  Scaleway Cloud  │
                       │   Infrastructure │
                       └──────────────────┘

The server acts as a bridge between MCP clients and the Scaleway cloud platform, providing a standardized interface for infrastructure management.