English Français العربية

io.cycloid.mcp/server

Registre officiel Autres

An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform

Code source Documentation

Que pouvez-vous faire avec io.cycloid.mcp/server ?

  • CYCLOID_BLUEPRINT_LIST: List all available blueprints with their details
  • CYCLOID_BLUEPRINT_STACK_CREATE: Create stacks from blueprints with interactive elicitation
  • CYCLOID_STACKFORMS_VALIDATE: Validate StackForms configuration files
  • CYCLOID_CATALOG_REPO_LIST: List service catalog repositories
  • CYCLOID_EVENT_LIST: List organization events with optional filters (begin, end, severity, type)
  • CYCLOID_PIPELINE_LIST: List all pipelines from Cycloid

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http server 'https://mcp.cycloid.io/mcp' --header 'X-CY-API-KEY: <API key for authentication>' --header 'X-CY-ORG: <The organization canonical name (tenant) you want to interact with>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "server": {
            "type": "http",
            "url": "https://mcp.cycloid.io/mcp",
            "headers": {
                "X-CY-API-KEY": "<API key for authentication>",
                "X-CY-ORG": "<The organization canonical name (tenant) you want to interact with>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Cycloid MCP Server
  2. Overview
  3. Available Tools
  4. Available Resources
  5. Architecture
  6. HTTP Transport
  7. Quick Start
  8. MCP Configuration
  9. Available Commands
  10. Contributing
  11. License

Cycloid MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with the Cycloid platform, enabling AI assistants to interact with Cycloid's infrastructure management capabilities through natural language.

Overview

The Cycloid MCP Server bridges the gap between AI assistants and Cycloid's powerful infrastructure automation platform. It enables users to:

  • Discover and explore available blueprints and service catalogs
  • Create and manage infrastructure stacks using Cycloid's blueprints
  • Interact naturally with complex infrastructure workflows through AI assistants
  • Leverage Cycloid's expertise in infrastructure as code and automation

Available Tools

  • CYCLOID_BLUEPRINT_LIST: List all available blueprints with their details
  • CYCLOID_BLUEPRINT_STACK_CREATE: Create stacks from blueprints with interactive elicitation
  • CYCLOID_STACKFORMS_VALIDATE: Validate StackForms configuration files
  • CYCLOID_CATALOG_REPO_LIST: List service catalog repositories
  • CYCLOID_EVENT_LIST: List organization events with optional filters (begin, end, severity, type)
  • CYCLOID_PIPELINE_LIST: List all pipelines from Cycloid

Available Resources

  • cycloid://blueprints: Access to blueprint information
  • cycloid://service-catalogs-repositories: Access to service catalog repositories information
  • cycloid://events: Access to recent organization events as JSON
  • cycloid://pipelines: Access to pipeline information
Event Filters
  • begin/end: Unix timestamps (strings) delimiting the time window
  • severity: One or more of info, warn, err, crit
  • type: One or more of Cycloid, AWS, Monitoring, Custom

Architecture

The server uses a dynamic component registration system based on FastMCP's MCPMixin:

  • Automatic Discovery: Components are automatically discovered from src/components/
  • File-based Organization: Components are organized by feature (catalogs/, stacks/)
  • Standard Patterns: Each component follows the pattern *_tools.py, *_resources.py, *_handlers.py, *_prompts.py
  • MCPMixin Integration: Uses FastMCP's built-in register_all() method for proper tool/resource registration

HTTP Transport

The Cycloid MCP Server runs as a web service using HTTP transport. Organization and API key are provided via HTTP headers (X-CY-ORG and X-CY-API-KEY) for each request, enabling multi-tenant usage.

Usage: python server.py

Quick Start

Prerequisites
  • Python 3.12 or higher
  • uv package manager (recommended)
  • Docker (for production deployment)
  • Valid Cycloid API credentials
Development Setup
# Clone and setup
git clone <repository-url>
cd cycloid-mcp-server
make setup

# Run development server
make dev-server
Production Setup
Using Pre-built Docker Images

The project provides pre-built Docker images via Docker Hub:

# Pull the latest image
docker pull cycloid/cycloid-mcp-server:latest

# Run the server
docker run -p 8010:8010 cycloid/cycloid-mcp-server:latest
Building Locally
# Build Docker image
make build

# Run production server
make prod-server

MCP Configuration

For detailed MCP server configuration examples, see mcp-examples.md.

Available Commands

# Development Environment
make setup          # Setup development environment with uv
make install        # Install dependencies
make help           # Show all available commands
make validate-env   # Validate local environment matches CI

# Development Server
make dev-server     # Run development server using Python virtual environment

# HTTP Server
python server.py  # Run HTTP server

# Production
make build          # Build Docker image
make prod-server    # Run production server using Docker

# Testing and Quality
make test           # Run all tests
make type-check     # Run pyright type checking
make lint           # Run PEP 8 linting with flake8
make format         # Format code with black and isort
make quality-check  # Run all quality checks (tests + type checking + linting)
make simulate-ci    # Validate environment and run quality checks

# Cleanup
make clean          # Clean up development artifacts
make clean-docker   # Clean up Docker artifacts

Contributing

See CONTRIBUTING.md for detailed development guidelines.

License

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

Questions fréquentes

Qu'est-ce que io.cycloid.mcp/server ?

An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform

Comment installer io.cycloid.mcp/server ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http server 'https://mcp.cycloid.io/mcp' --header 'X-CY-API-KEY: <API key for authentication>' --header 'X-CY-ORG: <The organization canonical name (tenant) you want to interact with>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.cycloid.mcp/server ?

Oui. Il attend X-CY-API-KEY, X-CY-ORG, à renseigner dans sa configuration.

io.cycloid.mcp/server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.cycloid.mcp/server ?

Il est publié par cycloidio. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.