Cycloid

io.cycloid.mcp由 mcp.cycloid.io 發布官方發布者v1.0.1更新於 Oct 30, 2026

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

已驗證Streamable HTTP可網頁執行雲端與基礎設施開發者工具

概覽

AI 產生的概覽

面向 Cycloid 內部開發入口網站的遠端 MCP 伺服器,讓助理瀏覽專案、環境、元件、藍圖、流水線與事件,並可從藍圖建立 stack。

可以做什麼
  • 列出並檢視專案、專案環境與元件,以及組織成員
  • 瀏覽藍圖與服務目錄儲存庫,並從藍圖建立 stack
  • 驗證 StackForms 設定檔並提供問題回饋
  • 列出流水線,以及組織層級或專案層級事件,可依動作、實體、嚴重程度或時間範圍篩選
適用情境
適合團隊在 Cycloid 上進行基礎設施即程式碼與平台工程的場景:讓助理檢視專案、環境與元件,回顧近期事件與流水線,或依藍圖建立新的 stack。
執行需求
透過 streamable HTTP 連線至 mcp.cycloid.io 遠端端點,無需本機安裝。每次請求需在 X-CY-API-KEY 標頭提供 Cycloid API 金鑰,並在 X-CY-ORG 標頭提供組織標準名稱。README 另列出 Python 3.12 與 Docker 供自行架設。
安裝前請注意
API 金鑰屬敏感憑證,會隨每次請求以標頭傳送,應限制權限並避免寫入日誌。組織標頭決定租戶,填錯可能存取到其他組織的資料。從藍圖建立 stack 會寫入 Cycloid 組織,並可能實際建立基礎設施。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Cycloid,將其新增到工作區。
  2. 連接 Custom headers 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.cycloid.mcp%2Fserver/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "cycloid": {
      "type": "http",
      "url": "https://mcp.cycloid.io/mcp",
      "headers": {
        "X-CY-API-KEY": "<VALUE>",
        "X-CY-ORG": "<VALUE>"
      }
    }
  }
}

README

Cycloid MCP Server

[PR Quality Check]

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

bash
# Clone and setupgit clone <repository-url>cd cycloid-mcp-servermake setup
# Run development servermake dev-server

Production Setup

Using Pre-built Docker Images

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

bash
# Pull the latest imagedocker pull cycloid/cycloid-mcp-server:latest
# Run the serverdocker run -p 8010:8010 cycloid/cycloid-mcp-server:latest
Building Locally
bash
# Build Docker imagemake build
# Run production servermake prod-server

MCP Configuration

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

Available Commands

bash
# Development Environmentmake setup          # Setup development environment with uvmake install        # Install dependenciesmake help           # Show all available commandsmake validate-env   # Validate local environment matches CI
# Development Servermake dev-server     # Run development server using Python virtual environment
# HTTP Serverpython server.py  # Run HTTP server
# Productionmake build          # Build Docker imagemake prod-server    # Run production server using Docker
# Testing and Qualitymake test           # Run all testsmake type-check     # Run pyright type checkingmake lint           # Run PEP 8 linting with flake8make format         # Format code with black and isortmake quality-check  # Run all quality checks (tests + type checking + linting)make simulate-ci    # Validate environment and run quality checks
# Cleanupmake clean          # Clean up development artifactsmake 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.

來源:README.md,提交 c9cd9e8

工具

13

CYCLOID_CATALOG_REPO_LIST

List all available service catalog repositories with their details. The LLM can filter the results based on user requirements.

無需輸入參數。

CYCLOID_COMPONENT_GET

Get the state of one or more components in a project environment.

輸入參數env必填project必填canonicals必填

CYCLOID_COMPONENT_LIST

List components in a project environment.

輸入參數env必填project必填

CYCLOID_EVENT_LIST

List organization events with optional filters. To filter by WHAT HAPPENED, use `action` (e.g. create, update, delete, configure, pause, unpause) and/or `entity` (e.g. component, ci_build, ci_job, pipeline, credential) — these are matched case-insensitively against each event's actual `action`/`entity` tag VALUE (note: the entity is `ci_build`, not `build`). If a filter matches nothing while events exist, the response lists the available_actions/available_entities to retry with. `type` is ONLY the high-level category: Cycloid, AWS, Monitoring, Custom (do NOT pass an action/entity name as `type`). `severity` is one of: info, warn, err, crit. `begin`/`end` are Unix timestamps in SECONDS (strings); omit any filter to include all of its values. Returns full event payload including tags. Actor identity is in tags as {key: 'user', value: '<username>'}.

輸入參數endtypebeginactionentityseverity

CYCLOID_PROJECT_EVENTS

List events scoped to a specific project's components. Walks project → envs → components, then filters org-wide events by project tag. Returns events, count, and a deduplicated actors list extracted from tags[key=user]. Actor usernames can be cross-referenced with CYCLOID_MEMBER_LIST to get numeric ids for building member URLs. Hard cap: aborts with a structured error if total components exceed the configured maximum (default 50). Use begin/end/severity/type/action/entity to narrow results. Filter by WHAT HAPPENED with `action` (e.g. create, update, delete, configure, pause, unpause) and/or `entity` (e.g. component, ci_build, ci_job, pipeline) — matched case-insensitively against each event's actual tag VALUE (the entity is `ci_build`, not `build`). If a filter matches nothing while events exist, the response lists available_actions/available_entities to retry with. `type` is ONLY the high-level category: Cycloid, AWS, Monitoring, Custom (do NOT pass an action/entity name as `type`). `severity` is one of: info, warn, err, crit.

輸入參數endtypebeginactionentityproject必填severity

CYCLOID_MEMBER_LIST

List all members of the organization. Use this to look up a member's numeric `id` from their `username`. The `id` field is required to build member URLs: /organizations/<org>/members/<id>.

無需輸入參數。

CYCLOID_PIPELINE_LIST

List all pipelines from Cycloid.

無需輸入參數。

CYCLOID_PROJECT_GET

Get one or more projects by canonical.

輸入參數canonicals必填

CYCLOID_PROJECT_LIST_ENV

List environments in a project.

輸入參數project必填

CYCLOID_PROJECT_LIST

List all projects in the organization.

無需輸入參數。

CYCLOID_STACKFORMS_VALIDATE

Validate a StackForms (.forms.yml) file using the Cycloid CLI. This tool can validate StackForms configuration and provide detailed feedback for fixing issues.

輸入參數forms_content必填

CYCLOID_BLUEPRINT_STACK_CREATE

Create a new Cycloid stack from a blueprint. CRITICAL: When elicitation context (ctx) is provided, the tool will ALWAYS use interactive elicitation to ask for parameters one by one, REGARDLESS of any parameters provided. The LLM should ONLY provide the 'ref' parameter and let elicitation handle the rest. DO NOT provide name, use_case, or service_catalog_source_canonical when elicitation is available.

輸入參數ref必填

CYCLOID_BLUEPRINT_LIST

List all available blueprints with their details. The LLM can filter the results based on user requirements.

無需輸入參數。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分