Showroom Docs MCP

Showroom Docs MCP Server

Quarkus MCP Server for OpenShift Lightspeed

______________________________________________________________________

MCP（模型上下文协议） 服务器构建于 夸库斯 该索引从 “从零到英雄的IA发展” 研讨会（Neuralbank）和官方文件 9红帽产品，将它们作为工具 换档轻速.

建筑

MCP工具

索引内容（46个文档，约3MB）

特性：自动净化的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

文档

包含分步设置的完整文档：

许可证

Apache许可证2.0