MCP服务器操作器

MCP服务器操作器用于在OpenShift集群上管理MCP(模型上下文协议)服务器的生命周期,支持通过CRD自定义部署配置。

  • by opendatahub-io
  • Go
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 opendatahub-io/mcp-server-operator

使用说明

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.23
  • Kubebuilder

运行测试

要运行单元测试,请运行:

make test

要运行端到端测试,请运行:

make test-e2e

贡献

欢迎投稿!请参阅我们的 贡献指南.