使用说明
MCP服务器操作员
这 MCP服务器操作员 管理OpenShift集群上MCP(模型上下文协议)服务器的生命周期。它利用了一个名为CRD的自定义资源定义 MCPServer,允许用户为自定义MCP服务器部署指定MCP服务器映像和运行时参数。
特性
- 通过CRD部署和管理MCP服务器实例
- 支持自定义容器映像和运行时参数
- 与Openshift集群兼容
- 包括端到端测试和单元测试。
目录
用法
先决条件
安装前,您需要运行以下操作程序:
- 一 OpenShift集群 (ROSA、OSD、CRC)或兼容的Kubernetes集群
- A. 集装箱发动机 (
podman或docker) - OpenShift CLI工具:
oc - 安装CRD和部署操作员的足够权限
安装
在执行任何这些步骤之前,如果使用以下步骤,请确保您已登录到集群:
oc login --token=<your user token> --server=<your openshift cluster server>
登录集群后,克隆存储库,然后交换到mcp服务器操作员文件夹:
git clone https://github.com/opendatahub-io/mcp-server-operator.git
cd mcp-server-operator
接下来,设置环境变量:
export IMG=<your-registry>/<username>/mcp-server-operator:<tag>
然后,构建图像:
CONTAINER_TOOL={docker|podman} IMG=$IMG make build
然后,安装必要的CRD:
make install
在本地运行操作员
make run
在集群上运行操作员
make deploy IMG=$IMG
创建MCP服务器实例
以下是一个关于如何创建MCPServer的示例,请确保在运行命令之前用适当的信息替换括号中的文本。
cat << EOF | oc create -f -
apiVersion: mcpserver.opendatahub.io/v1
kind: MCPServer
metadata:
name: <your_name_here>
namespace: mcp-server-operator-system
spec:
image: <your_image_here>
args:
- <arg 1>
- <arg 2>
command:
- <command 1>
- <command 2>
EOF
字段描述
image:MCP服务器的容器映像。args:(可选)要传递给MCP服务器容器的运行时参数列表。command:(可选)要传递给MCP服务器容器的入口点命令的列表。
卸载操作员并清洁集群
首先,使用以下命令从集群中删除MCPServer对象:
oc delete mcpserver -n mcp-server-operator-system [name]
接下来是卸载操作符,只需运行以下命令即可完成。
make undeploy
开发者指南
先决条件
Go 1.23Kubebuilder
运行测试
要运行单元测试,请运行:
make test
要运行端到端测试,请运行:
make test-e2e
贡献
欢迎投稿!请参阅我们的 贡献指南.