CNCF技术顾问MCP服务器
用于CNCF景观技术数据的MCP服务器。访问2398+个CNCF项目、GitHub指标、成熟度状态和案例研究,以获得技术决策支持。
✨ 快速开始
# 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🚀 安装
选项1:NPM(推荐)-不需要Java! 📦
克劳德桌面/克劳德代码集成
添加 ~/.claude/settings.json (Claude Code)或您的MCP客户端配置:
{
"mcpServers": {
"mcp-cncf-tech-advisor": {
"command": "npx",
"args": ["-y", "mcp-mcp-mcp-cncf-tech-advisor@latest"]
}
}
}VS代码/光标/风帆
{
"mcpServers": {
"mcp-cncf-tech-advisor": {
"command": "npx",
"args": ["-y", "mcp-mcp-mcp-cncf-tech-advisor@latest"]
}
}
}全球安装
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选项2:Docker(生产)🐳
# 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选项3:从源代码构建(开发)🔧
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🚢 部署脚本
自动化部署
该项目包括不同平台的自动化部署脚本:
Docker部署
# 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 --pushKubernetes部署
# Deploy to staging
./scripts/deploy.sh -p k8s -e staging
# Deploy to production
./scripts/deploy.sh -p k8s -e productionNPM部署
# Publish to NPM registry
./scripts/deploy.sh -p npm --push
# Publish with custom tag
./scripts/deploy.sh -p npm --tag beta配置选项
环境变量
# 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
quarkus.mcp.server.stdio.enabled=true
quarkus.mcp.server.http.root-path=/mcp
quarkus.http.cors.enabled=true
quarkus.http.cors.origins=*☸️ Kubernetes部署
Kubernetes清单
# 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使用Helm部署(可选)
# 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管道
该项目包括一个使用GitHub Actions的全面CI/CD管道:
自动化工作流程
- 测试:多平台测试(Linux、macOS、Windows)
- 建筑:JVM和本机构建
- 扫描:使用Trivy进行安全漏洞扫描
- 部署:Docker镜像发布、NPM发布
- 整合:端到端MCP协议测试
构建触发器
- 向主要/发展分支机构推进
- 拉取请求
- 释放事件
手动测试
# Run full test suite
./scripts/test.sh
# Test MCP protocol
docker/scripts/mcp-test.sh
# Health check
curl -f http://localhost:8080/q/health🔧 配置
环境变量
QUARKUS_MCP_SERVER_STDIO_ENABLED=true-启用stdio传输(CLI的默认设置)QUARKUS_MCP_SERVER_HTTP_ROOT_PATH=/mcp-HTTP端点路径QUARKUS_HTTP_PORT=8080-HTTP服务器端口CNCF_ADVISOR_LOG_LEVEL=INFO-日志级别(调试、信息、警告、错误)
Claude桌面集成
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"cncf-tech-advisor": {
"command": "mcp-cncf-tech-advisor"
}
}
}🛠️ 可用工具(8)
项目搜索与分析
- 搜索项目 -按关键字、类别或成熟度级别搜索CNCF项目
- 获取项目详细信息 -获取特定CNCF项目的详细信息
- getProjectMetrics -GitHub项目指标和社区统计
- getProjectMaturity -CNCF成熟度状态和进展时间表
- getProjectsBy类别 -列出特定类别中的所有项目
案例研究和现实世界的例子
- 搜索案例研究 -搜索CNCF案例研究和最终用户示例
- 按项目获取案例研究 -获取使用特定项目的案例研究
- 获取所有案例研究 -通过过滤获取所有可用的CNCF案例研究
✨ 特性
- O(1)搜索:对2398+个CNCF项目进行超快速索引
- 实时数据:来自CNCF Landscape API的自动更新
- 智能评分:相关性和流行度算法
- 全面的:项目详细信息、GitHub指标、成熟度状态
- 真实世界的例子:案例研究和最终用户实施
- 多平台支持:macOS(ARM64/x64),Linux(x64),Windows(x64)
- 无Java依赖关系:用于生产部署的本机二进制文件
💡 示例提示
项目发现
"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"项目分析
"Compare Prometheus and Grafana metrics"
"What's the maturity status of Istio?"
"Show me GitHub metrics for Kubernetes"
"Find popular container orchestration tools"案例研究和现实世界的例子
"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"技术决策支持
"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技术顾问mcp/ ├── src/main/java/io/mcp/cncf/ │ ├── 分析器/#分析和推荐引擎 │ ├── 客户端/#CNCF API集成 │ ├── config/#配置类 │ ├── model/#数据模型和记录 │ ├── prompt/#MCP提示模板 │ └── 工具/#MCP工具实现 ├── src/main/resources/ │ └── application.properties ├── src/test/java/ ├── npm/#npm包装器,便于分发 └── Dockerfile#多阶段原生构建
## 🔧 Development
### Prerequisites
- Java 25+ (for development/builder)
- Maven 3.9+
- Docker (optional, for native build)
### Building
Build JAR
./mvnw package
Build native executable
./mvnw package -Dnative
Run tests
./mvnw test
Run in dev mode
./mvnw quarkus:dev
### 测试MCP服务器
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
## 📊 支持的技术类别
- **编排** -Kubernetes、Docker等。
- **运行时** -容器运行时、无服务器平台
- **配置** -基础设施即代码、云配置
- **可观测性** -监控、记录、追踪
- **服务发现** -服务发现和配置
- **服务网格** -服务网格实现
- **网络** -CNI、负载均衡器、入口
- **安全** -身份验证、授权、机密
- **数据库** -数据库和数据存储
- **存储** -持久存储解决方案
- **流媒体** -消息队列和流媒体平台
- **无服务器** -FaaS和无服务器平台
- **整合** -集成和消息传递
- **政策** -政策作为代码,授权
- **工件管理** -工件存储库和注册表
## 🤝 贡献
欢迎投稿!请查看我们的 [贡献指南](CONTRIBUTING.md) 了解详情。
### 开发过程
1. 分叉存储库
1. 创建要素分支(`git checkout -b feature/amazing-feature`)
1. 提交您的更改(`git commit -m 'Add amazing feature'`)
1. 推到分支(`git push origin feature/amazing-feature`)
1. 打开拉取请求
## 📄 许可证
此项目根据Apache许可证2.0获得许可-请参阅 [许可证](LICENSE) 文件以获取详细信息。
## 🙏 致谢
- [云原生计算基金会](https://cncf.io/) 对于令人惊叹的云原生生态系统
- [夸库斯](https://quarkus.io/) 用于超音速亚原子Java框架
- [主控程序](https://modelcontextprotocol.io/) 对于模型上下文协议
## 📞 支持
- **文档**: [维基工程](https://github.com/jeanlopezxyz/mcp-cncf-tech-advisor-mcp/wiki)
- **问题**:
- **讨论**:
## 🌟 明星历史
[](https://star-history.com/#jeanlopezxyz/mcp-cncf-tech-advisor-mcp&Date)
______________________________________________________________________
由...制作❤️ 通过 [让·洛佩兹](https://github.com/jeanlopezxyz)