使用说明
Showroom Docs MCP Server
Quarkus MCP Server for OpenShift Lightspeed
MCP（模型上下文协议） 服务器构建于 夸库斯 该索引从 “从零到英雄的IA发展” 研讨会（Neuralbank）和官方文件 9红帽产品，将它们作为工具 换档轻速.
建筑
MCP工具
| 工具 | 说明 |
|---|---|
searchDocs |
在所有索引文档中搜索关键字 |
listDocSections |
列出所有可用的文档部分 |
getDocSection |
获取章节的完整内容（支持模糊主题匹配） |
getDocSummary |
知识库概述，包括统计数据和示例查询 |
索引内容（46个文档，约3MB）
| 来源 | 文档 | 主题 |
|---|---|---|
| Neuralbank研讨会 | 27 | 商业案例、MCP代理、Golden Path、DevSpaces、Keycloak、Connectivity Link、RAG、LLM、代理、GPU、平台工程、数据工程 |
| Red Hat产品 | 9 | Service Mesh 3.3、Connectivity Link 1.3、Developer Hub 1.9、Lightspeed 1.0、Observability、OpenTelemetry 3.9、Pipelines 1.21、API Mgmt、OpenShift AI |
| 开发者产品 | 10 | Quarkus、OpenShift、RHEL、开发者空间、OpenShift AI、开发者中心、Ansible、OpenShift本地、连接链接、3scale |
特性：自动净化的PDF内容（没有页码/法律工件），developers.redhat.com的快速启动CLI示例，段落边界的智能截断。
快速开始
1.使用Helm部署（推荐）
helm repo add showroom-docs-mcp \
https://maximilianopizarro.github.io/showroom-docs-mcp/
helm install showroom-docs-mcp showroom-docs-mcp/showroom-docs-mcp \
--namespace openshift-lightspeed \
--set image.pullPolicy=Always
2.配置OLSConfig
应用提供的 cluster-ols.yml 或者将MCP服务器添加到现有的OLSConfig中：
# Option A: Use the provided sample (edit LLM provider as needed)
oc apply -f k8s/cluster-ols.yml
# Option B: Add to your existing OLSConfig
apiVersion: ols.openshift.io/v1alpha1
kind: OLSConfig
metadata:
name: cluster
spec:
featureGates:
- MCPServer
mcpServers:
- name: showroom-docs-mcp
timeout: 10
url: 'http://showroom-docs-mcp.openshift-lightspeed.svc.cluster.local:8080/mcp'
# ... rest of your OLS configuration
重要：使用
/mcp（流式HTTP），不是/mcp/sse.OLS使用需要Streamable HTTP端点的POST请求。
3.验证
# Check MCP pod is running
oc get pods -n openshift-lightspeed -l app=showroom-docs-mcp
# Check OLS loaded the tools
oc logs -n openshift-lightspeed deploy/lightspeed-app-server \
-c lightspeed-service-api | grep "tools from MCP"
# Expected: Loaded 4 tools from MCP server 'showroom-docs-mcp'
4.光速测试
打开OpenShift控制台，询问Lightspeed：
- “如何安装OpenShift Service Mesh 3.3？”
- “解释红帽开发者中心的架构”
- “使用OpenShift AI部署模型的步骤是什么？”
- “Neuralbank研讨会是关于什么的？”
- “如何使用Quarkus构建MCP代理？”
本地开发
./mvnw quarkus:dev
# MCP at http://localhost:8080/mcp
构建
podman build -t quay.io/maximilianopizarro/showroom-docs-mcp:latest -f Containerfile .
podman push quay.io/maximilianopizarro/showroom-docs-mcp:latest
文档
包含分步设置的完整文档： https://maximilianopizarro.github.io/showroom-docs-mcp
许可证
Apache许可证2.0
