How do I use cncf-tech-advisor-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@cncf-tech-advisor-mcp get details on the Prometheus project" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

cncf-tech-advisor-mcp

by jeanlopezxyz

Overview Schema Related Servers Score Discussions

Remote

CNCF Tech Advisor MCP Server

MCP Server for CNCF Landscape Technology Data. Access 2,398+ CNCF projects, GitHub metrics, maturity status, and case studies for technology decision support.

✨ Quick Start

# Install and run (no Java required!)
npx mcp-mcp-mcp-cncf-tech-advisor@latest

# With HTTP transport (for MCP Inspector)
npx mcp-mcp-mcp-cncf-tech-advisor@latest --port 8080

Related MCP server: OSSInsight MCP Server

🚀 Installation

Option 1: NPM (Recommended) - No Java Required! 📦

Claude Desktop / Claude Code Integration

Add to ~/.claude/settings.json (Claude Code) or your MCP client config:

{
  "mcpServers": {
    "mcp-cncf-tech-advisor": {
      "command": "npx",
      "args": ["-y", "mcp-mcp-mcp-cncf-tech-advisor@latest"]
    }
  }
}

VS Code / Cursor / Windsurf

{
  "mcpServers": {
    "mcp-cncf-tech-advisor": {
      "command": "npx",
      "args": ["-y", "mcp-mcp-mcp-cncf-tech-advisor@latest"]
    }
  }
}

Global Installation

npm install -g mcp-mcp-cncf-tech-advisor

# Start the MCP server
mcp-mcp-cncf-tech-advisor

# HTTP mode for testing
mcp-mcp-cncf-tech-advisor --port 8080

Option 2: Docker (Production) 🐳

# Pull and run native image
docker run -i --rm -p 8080:8080 ghcr.io/jeanlopezxyz/mcp-cncf-tech-advisor:latest

# MCP STDIO usage
docker run -i --rm ghcr.io/jeanlopezxyz/mcp-cncf-tech-advisor:latest \
  -Dquarkus.mcp.server.stdio.enabled=true

Option 3: Build from Source (Development) 🔧

git clone https://github.com/jeanlopezxyz/mcp-cncf-tech-advisor-mcp.git
cd mcp-cncf-tech-advisor-mcp

# Build native binary
./mvnw package -DskipTests -Dnative

# Run
./target/*-runner

🚢 Deployment Scripts

Automated Deployment

The project includes automated deployment scripts for different platforms:

Docker Deployment

# Build and push to registry
./scripts/deploy.sh -p docker --push

# Development deployment
./scripts/deploy.sh -p docker -e dev --dev

# Native build with push
./scripts/deploy.sh -p docker --native --push

Kubernetes Deployment

# Deploy to staging
./scripts/deploy.sh -p k8s -e staging

# Deploy to production
./scripts/deploy.sh -p k8s -e production

NPM Deployment

# Publish to NPM registry
./scripts/deploy.sh -p npm --push

# Publish with custom tag
./scripts/deploy.sh -p npm --tag beta

Configuration Options

Environment Variables

# Java options
export JAVA_OPTS="-Xmx1g -Xms512m"

# MCP transport configuration
export STDIO_ENABLED=true
export HTTP_ENABLED=true

# Application settings
export QUARKUS_HTTP_PORT=8080
export QUARKUS_LOG_LEVEL=INFO

Application Properties

# application.properties
quarkus.mcp.server.stdio.enabled=true
quarkus.mcp.server.http.root-path=/mcp
quarkus.http.cors.enabled=true
quarkus.http.cors.origins=*

☸️ Kubernetes Deployment

Kubernetes Manifests

# k8s/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: mcp-cncf-tech-advisor
spec:
  replicas: 3
  selector:
    matchLabels:
      app: mcp-cncf-tech-advisor
  template:
    metadata:
      labels:
        app: mcp-cncf-tech-advisor
    spec:
      containers:
      - name: mcp-cncf-tech-advisor
        image: ghcr.io/jeanlopezxyz/mcp-cncf-tech-advisor-mcp:latest
        ports:
        - containerPort: 8080
        env:
        - name: QUARKUS_MCP_SERVER_STDIO_ENABLED
          value: "false"
        - name: QUARKUS_MCP_SERVER_HTTP_ROOT_PATH
          value: "/mcp"
        resources:
          requests:
            memory: "256Mi"
            cpu: "250m"
          limits:
            memory: "512Mi"
            cpu: "500m"
        livenessProbe:
          httpGet:
            path: /q/health
            port: 8080
          initialDelaySeconds: 30
          periodSeconds: 10
        readinessProbe:
          httpGet:
            path: /q/health
            port: 8080
          initialDelaySeconds: 5
          periodSeconds: 5
---
apiVersion: v1
kind: Service
metadata:
  name: mcp-cncf-tech-advisor
spec:
  selector:
    app: mcp-cncf-tech-advisor
  ports:
  - port: 8080
    targetPort: 8080
  type: ClusterIP

Deploy with Helm (Optional)

# Add Helm repository
helm repo add mcp-cncf-tech-advisor https://charts.jeanlopez.tech
helm repo update

# Install chart
helm install mcp-cncf-tech-advisor mcp-cncf-tech-advisor/mcp-cncf-tech-advisor \
  --set image.tag=latest \
  --set replicas=3 \
  --set resources.requests.memory=512Mi

🔄 CI/CD Pipeline

The project includes a comprehensive CI/CD pipeline using GitHub Actions:

Automated Workflows

Testing: Multi-platform tests (Linux, macOS, Windows)
Building: JVM and native builds
Scanning: Security vulnerability scanning with Trivy
Deployment: Docker image publishing, NPM publishing
Integration: End-to-end MCP protocol testing

Build Triggers

Push to main/develop branches
Pull requests
Release events

Manual Testing

# Run full test suite
./scripts/test.sh

# Test MCP protocol
docker/scripts/mcp-test.sh

# Health check
curl -f http://localhost:8080/q/health

🔧 Configuration

Environment Variables

QUARKUS_MCP_SERVER_STDIO_ENABLED=true - Enable stdio transport (default for CLI)
QUARKUS_MCP_SERVER_HTTP_ROOT_PATH=/mcp - HTTP endpoint path
QUARKUS_HTTP_PORT=8080 - HTTP server port
CNCF_ADVISOR_LOG_LEVEL=INFO - Log level (DEBUG, INFO, WARN, ERROR)

Claude Desktop Integration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cncf-tech-advisor": {
      "command": "mcp-cncf-tech-advisor"
    }
  }
}

🛠️ Available Tools (8)

Project Search & Analysis

searchProjects - Search CNCF projects by keyword, category, or maturity level
getProjectDetails - Get detailed information about a specific CNCF project
getProjectMetrics - GitHub metrics and community statistics for projects
getProjectMaturity - CNCF maturity status and progression timeline
getProjectsByCategory - List all projects in a specific category

Case Studies & Real-World Examples

searchCaseStudies - Search for CNCF case studies and end-user examples
getCaseStudiesByProject - Get case studies that use a specific project
getAllCaseStudies - Get all available CNCF case studies with filtering

✨ Features

O(1) Search: Ultra-fast indexing of 2,398+ CNCF projects
Live Data: Automatic updates from CNCF Landscape API
Smart Scoring: Relevance and popularity algorithms
Comprehensive: Project details, GitHub metrics, maturity status
Real-world Examples: Case studies and end-user implementations
Multi-platform Support: macOS (ARM64/x64), Linux (x64), Windows (x64)
No Java Dependencies: Native binaries for production deployment

💡 Example Prompts

Project Discovery

"Search for observability technologies in CNCF"
"Show me graduated projects related to service mesh"
"Find container runtime projects"
"List all projects in the serverless category"

Project Analysis

"Compare Prometheus and Grafana metrics"
"What's the maturity status of Istio?"
"Show me GitHub metrics for Kubernetes"
"Find popular container orchestration tools"

Case Studies & Real-World Examples

"Find case studies using Kubernetes"
"Search for microservices case studies"
"Show me end-user implementations of monitoring solutions"
"Get case studies about service mesh in production"

Technology Decision Support

"What are the best CNCF projects for logging?"
"Recommend projects for API gateway needs"
"Show me mature networking projects"
"Find projects with high community activity"

## 🏗️ Architecture

mcp-cncf-tech-advisor-mcp/ ├── src/main/java/io/mcp/cncf/ │ ├── analyzer/ # Analysis and recommendation engine │ ├── client/ # CNCF API integration │ ├── config/ # Configuration classes │ ├── model/ # Data models and records │ ├── prompt/ # MCP prompt templates │ └── tool/ # MCP tool implementations ├── src/main/resources/ │ └── application.properties ├── src/test/java/ ├── npm/ # NPM wrapper for easy distribution └── Dockerfile # Multi-stage native build


## 🔧 Development

### Prerequisites

- Java 25+ (for development/builder)
- Maven 3.9+
- Docker (optional, for native build)

### Building

```bash
# Build JAR
./mvnw package

# Build native executable
./mvnw package -Dnative

# Run tests
./mvnw test

# Run in dev mode
./mvnw quarkus:dev

Testing the MCP Server

# Start with stdio transport
java -jar target/mcp-cncf-tech-advisor-mcp-1.0.0-runner.jar \
  -Dquarkus.mcp.server.stdio.enabled=true

# Or start with HTTP transport
java -jar target/mcp-cncf-tech-advisor-mcp-1.0.0-runner.jar
# MCP endpoint: http://localhost:8080/mcp
# SSE endpoint: http://localhost:8080/mcp/sse

📊 Supported Technology Categories

Orchestration - Kubernetes, Docker, etc.
Runtime - Container runtimes, serverless platforms
Provisioning - Infrastructure as code, cloud provisioning
Observability - Monitoring, logging, tracing
Service Discovery - Service discovery and configuration
Service Mesh - Service mesh implementations
Networking - CNI, load balancers, ingress
Security - Authentication, authorization, secrets
Database - Databases and data stores
Storage - Persistent storage solutions
Streaming - Message queues and streaming platforms
Serverless - FaaS and serverless platforms
Integration - Integration and messaging
Policy - Policy as code, authorization
Artifact Management - Artifact repositories and registries

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide for details.

Development Process

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

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

🙏 Acknowledgments

CNCF for the amazing cloud-native ecosystem
Quarkus for the supersonic subatomic Java framework
MCP for the Model Context Protocol

📞 Support

Documentation: Project Wiki
Issues: GitHub Issues
Discussions: GitHub Discussions

🌟 Star History

Made with ❤️ by Jean Lopez

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jeanlopezxyz/cncf-tech-advisor-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server