MCP运行时平台
      
MCP Runtime是一个自托管的Kubernetes控制平面,用于内部 模型上下文协议 服务器。它提供声明性MCP服务器部署、注册表工作流、操作员协调、请求路径治理、访问/会话资源、审计、分析、仪表板以及用于浏览和操作MCP服务器的平台控制界面。
公共平台在 platform.mcpruntime.org 是可部署平台体验的实时预览。它运行公共预览目录模式,访问者可以浏览公共预览MCP服务器,登录的预览用户可以发布到公共目录命名空间中。它仍然不是一个通用的公共MCP市场。公司可以在自己的Kubernetes集群中部署相同的模型,然后通过CLI和代理、IDE和直接人工工作流的平台控制界面来托管、管理、治理和审计MCP服务器。
- 网站
- 平台预览 用于平台控制面;公司可以在自己的集群中部署相同的模型
- 文档 和
docs/ - API 参考 和
docs/api.md - 早期采用者:MCP Runtime正在寻找运行或评估内部MCP平台的团队。打开一个 根据您的用例、集群形状或集成反馈。
\[!小心\] MCP Runtime是alpha软件。API、命令和行为仍在不断发展。使用文档、CRD和 api/v1alpha1 在生产使用之前,将类型作为真理的来源。什么船
mcp-runtimeCLI用于setup,status,registry,server,pipeline,cluster,access,以及sentinelmcp-runtime adapter proxy和mcp-runtime adapter stdio子命令用于
管理HTTP和stdio代理集成。两者都可以从以下位置获取身份信息 平台与 --server --agent [--auto-refresh],或 接受明确 MCP_RUNTIME_* env变量(请参见 代理适配器)
- 用于经过身份验证的MCP目录浏览、平台状态和web操作的平台UI
MCPServer,MCPAccessGrant,以及MCPAgentSessionCRD- Kubernetes操作员
Deployment,Service,Ingress,以及政策的具体化 - 内部或已配置的注册表工作流
- 身份、工具策略、信任和审计发布的可选网关实施
- 用于摄取、处理、API、UI和可观察性的捆绑Sentinel堆栈
它与MCP目录有何不同
这 MCP官方登记处 以及公共MCP目录,如 格拉玛, 铁匠铺, , PulseMCP, mcp.so,和特定于客户端的目录是有用的发现和安装界面。MCP Runtime是不同的:它是一个可部署的操作层,用于在公司自己的环境中运行MCP服务器。它可以提供类似内部目录的视图,但主要产品是部署、治理、代理访问、审计、合规性证据和第二天操作。
| 公共MCP目录或目录 | MCP运行时 |
|---|---|
| 帮助用户查找或安装公共MCP服务器 | 帮助公司托管、部署、管理、观察和审核自己的MCP服务器 |
| 优化发现元数据、流行度和安装片段 | 优化部署、运行时治理、Kubernetes协调、策略、会话、审计和合规性 |
| 通常作为第三方托管目录或客户端功能运行 | 在公司的Kubernetes环境或托管预览形状中运行 |
| 在配置或连接处停止 | 拥有通过代理/网关的受管请求路径 |
截至2026年4月,我们还没有发现另一种开源MCP产品将可部署的Kubernetes控制平面、注册表工作流、代理请求路径、访问/会话模型、审计管道和操作控制表面组合在一个包中。
需求
主机工具:
- 去
1.25+ - 制造
- Docker或与Docker兼容的客户端,守护进程正在运行
kubectl上PATH,为目标集群配置curl,jq,以及python3用于记录开发和流量生成流kind对于基于本地Kind的集群
集群先决条件:
- 正在运行的Kubernetes集群:kind、k3s、minikube、Docker Desktop Kubernetes、EKS或同等集群
- 工作DNS、默认存储类、入口和分发的负载平衡路径
- 看
docs/cluster-readiness.md在运行类似生产的安装之前
mcp-runtime setup 安装平台堆栈,包括ClickHouse和Kafka等Sentinel服务。您不需要为默认流单独安装这些。
快速开始
make deps-install # best-effort host install where supported
STRICT_DEPS_CHECK=1 make deps-check
make deps
make build
./bin/mcp-runtime bootstrap
./bin/mcp-runtime setup
./bin/mcp-runtime status笔记:
make deps-install这是最好的努力。它无法启动Docker Desktop、创建云凭据或为您配置kubeconfig。make deps检查主机工具并下载Go模块。它不会创建Kubernetes集群。make build生产./bin/mcp-runtime.- 想要一次性本地Kind安装的贡献者应使用
测试模式流程 docs/getting-started.md 和详细 docs/contributor/ 导游。
- 要对真实的MCP路由进行代理端治理,请使用
examples/governed-agent demo。
常用命令
./bin/mcp-runtime bootstrap # preflight cluster prerequisites
./bin/mcp-runtime setup # install platform stack
./bin/mcp-runtime status # show platform health
./bin/mcp-runtime registry status # inspect registry
./bin/mcp-runtime server status # inspect MCP servers
./bin/mcp-runtime access grant list # inspect access grants
./bin/mcp-runtime sentinel status # inspect Sentinel stack发展检查
gofmt -s -l .
go build -o bin/mcp-runtime ./cmd/mcp-runtime
go test ./... -count=1 -race
go vet ./...对于目标测试、e2e设置和调试运行手册,请使用 AGENTS.md 以及文档网站。
代理工具配置
仓库将Claude特定的本地配置保存在 .claude/.它 skills 条目应该是指向的符号链接 ../.codex/skills,因此Claude Desktop和Codex CLI在本地开发过程中发现了相同的存储库技能。
许可证
麻省理工学院
