{"id":34281148,"url":"https://github.com/cycloidio/cycloid-mcp-server","last_synced_at":"2026-01-27T10:19:08.370Z","repository":{"id":317380727,"uuid":"1033281821","full_name":"cycloidio/cycloid-mcp-server","owner":"cycloidio","description":"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.","archived":false,"fork":false,"pushed_at":"2025-10-08T12:47:30.000Z","size":9886,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-08T14:40:55.745Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cycloidio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-06T15:13:51.000Z","updated_at":"2025-10-08T12:47:31.000Z","dependencies_parsed_at":"2025-09-30T15:24:05.025Z","dependency_job_id":"8bbb8ce0-25c1-48a6-b0f3-5cfb5be2c7fc","html_url":"https://github.com/cycloidio/cycloid-mcp-server","commit_stats":null,"previous_names":["cycloidio/cycloid-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cycloidio/cycloid-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cycloidio%2Fcycloid-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cycloidio%2Fcycloid-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cycloidio%2Fcycloid-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cycloidio%2Fcycloid-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cycloidio","download_url":"https://codeload.github.com/cycloidio/cycloid-mcp-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cycloidio%2Fcycloid-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28811618,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T07:41:26.337Z","status":"ssl_error","status_checked_at":"2026-01-27T07:41:08.776Z","response_time":168,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-16T23:00:37.557Z","updated_at":"2026-01-27T10:19:08.364Z","avatar_url":"https://github.com/cycloidio.png","language":"Python","funding_links":[],"categories":["MCP Servers Directory"],"sub_categories":["Quick Submission"],"readme":"# Cycloid MCP Server\n\n[![PR Quality Check](https://github.com/cycloidio/cycloid-mcp-server/workflows/PR%20Quality%20Check/badge.svg)](https://github.com/cycloidio/cycloid-mcp-server/actions/workflows/pr-quality-check.yml)\n\nA 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.\n\n## Overview\n\nThe Cycloid MCP Server bridges the gap between AI assistants and Cycloid's powerful infrastructure automation platform. It enables users to:\n\n- **Discover and explore** available blueprints and service catalogs\n- **Create and manage** infrastructure stacks using Cycloid's blueprints\n- **Interact naturally** with complex infrastructure workflows through AI assistants\n- **Leverage Cycloid's expertise** in infrastructure as code and automation\n\n\n## Available Tools\n\n- **`CYCLOID_BLUEPRINT_LIST`**: List all available blueprints with their details\n- **`CYCLOID_BLUEPRINT_STACK_CREATE`**: Create stacks from blueprints with interactive elicitation\n- **`CYCLOID_STACKFORMS_VALIDATE`**: Validate StackForms configuration files\n- **`CYCLOID_CATALOG_REPO_LIST`**: List service catalog repositories\n- **`CYCLOID_EVENT_LIST`**: List organization events with optional filters (`begin`, `end`, `severity`, `type`)\n- **`CYCLOID_PIPELINE_LIST`**: List all pipelines from Cycloid\n\n## Available Resources\n\n- **`cycloid://blueprints`**: Access to blueprint information\n- **`cycloid://service-catalogs-repositories`**: Access to service catalog repositories information\n- **`cycloid://events`**: Access to recent organization events as JSON\n- **`cycloid://pipelines`**: Access to pipeline information\n\n### Event Filters\n- **begin/end**: Unix timestamps (strings) delimiting the time window\n- **severity**: One or more of `info`, `warn`, `err`, `crit`\n- **type**: One or more of `Cycloid`, `AWS`, `Monitoring`, `Custom`\n\n## Architecture\n\nThe server uses a dynamic component registration system based on FastMCP's MCPMixin:\n\n- **Automatic Discovery**: Components are automatically discovered from `src/components/`\n- **File-based Organization**: Components are organized by feature (`catalogs/`, `stacks/`)\n- **Standard Patterns**: Each component follows the pattern `*_tools.py`, `*_resources.py`, `*_handlers.py`, `*_prompts.py`\n- **MCPMixin Integration**: Uses FastMCP's built-in `register_all()` method for proper tool/resource registration\n\n## HTTP Transport\n\nThe 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.\n\n**Usage:** `python server.py`\n\n## Quick Start\n\n### Prerequisites\n\n- Python 3.12 or higher\n- [uv](https://github.com/astral-sh/uv) package manager (recommended)\n- Docker (for production deployment)\n- Valid Cycloid API credentials\n\n### Development Setup\n\n```bash\n# Clone and setup\ngit clone \u003crepository-url\u003e\ncd cycloid-mcp-server\nmake setup\n\n# Run development server\nmake dev-server\n```\n\n### Production Setup\n\n#### Using Pre-built Docker Images\n\nThe project provides pre-built Docker images via Docker Hub:\n\n```bash\n# Pull the latest image\ndocker pull cycloid/cycloid-mcp-server:latest\n\n# Run the server\ndocker run -p 8000:8000 cycloid/cycloid-mcp-server:latest\n```\n\n#### Building Locally\n\n```bash\n# Build Docker image\nmake build\n\n# Run production server\nmake prod-server\n```\n\n## MCP Configuration\n\nFor detailed MCP server configuration examples, see [mcp-examples.md](mcp-examples.md).\n\n## Available Commands\n\n```bash\n# Development Environment\nmake setup          # Setup development environment with uv\nmake install        # Install dependencies\nmake help           # Show all available commands\nmake validate-env   # Validate local environment matches CI\n\n# Development Server\nmake dev-server     # Run development server using Python virtual environment\n\n# HTTP Server\npython server.py  # Run HTTP server\n\n# Production\nmake build          # Build Docker image\nmake prod-server    # Run production server using Docker\n\n# Testing and Quality\nmake test           # Run all tests\nmake type-check     # Run pyright type checking\nmake lint           # Run PEP 8 linting with flake8\nmake format         # Format code with black and isort\nmake quality-check  # Run all quality checks (tests + type checking + linting)\nmake simulate-ci    # Validate environment and run quality checks\n\n# Cleanup\nmake clean          # Clean up development artifacts\nmake clean-docker   # Clean up Docker artifacts\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development guidelines.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcycloidio%2Fcycloid-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcycloidio%2Fcycloid-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcycloidio%2Fcycloid-mcp-server/lists"}