MCP Runtime

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-runtime CLI用于 setup, status, registry, server, pipeline, cluster, access，以及 sentinel
• mcp-runtime adapter proxy 和 mcp-runtime adapter stdio 子命令用于

管理HTTP和stdio代理集成。两者都可以从以下位置获取身份信息 平台与 --server --agent [--auto-refresh]，或 接受明确 MCP_RUNTIME_* env变量（请参见 代理适配器)

• 用于经过身份验证的MCP目录浏览、平台状态和web操作的平台UI
• MCPServer, MCPAccessGrant，以及 MCPAgentSession CRD
• Kubernetes操作员 Deployment, Service, Ingress，以及政策的具体化
• 内部或已配置的注册表工作流
• 身份、工具策略、信任和审计发布的可选网关实施
• 用于摄取、处理、API、UI和可观察性的捆绑Sentinel堆栈

它与MCP目录有何不同

这 MCP官方登记处 以及公共MCP目录，如 格拉玛, 铁匠铺, , PulseMCP, mcp.so，和特定于客户端的目录是有用的发现和安装界面。MCP Runtime是不同的：它是一个可部署的操作层，用于在公司自己的环境中运行MCP服务器。它可以提供类似内部目录的视图，但主要产品是部署、治理、代理访问、审计、合规性证据和第二天操作。

截至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在本地开发过程中发现了相同的存储库技能。

许可证

麻省理工学院