快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

npx @saptak/egmcp-server stdio-tools --envoy-url http://localhost:19001

详细介绍

EGMCP服务器-Envoy网关MCP服务器

](https://www.npmjs.com/package/@saptak/egmcp-server) ](https://github.com/saptak/eg-mcp-server/releases) ![License: MIT](https://opensource.org/licenses/MIT)

一个生产就绪的模型上下文协议（MCP）服务器，为Claude Desktop提供对Envoy网关配置、监控和 全面的交通管理能力 具有先进的交通控制功能。

🎯 概述

EGMCP服务器连接了Claude Desktop和Envoy Gateway，支持自然语言查询和 全面管理 您的服务网格基础设施。它提供对侦听器、路由、集群、完整路由生命周期管理和复杂流量工程功能的实时访问。

✨ 主要特点

🔍 监控与发现

🔌 实时配置访问：与Envoy网关管理员API的实时连接
📊 资源发现：侦听器、路由和集群的动态列表
🛠️ 交互式工具：11个专用工具，用于完整的Envoy网关管理
🔒 稳健的错误处理：优雅的降级和超时保护

🚀 路线管理

🛣️ HTTP路由创建：通过自然语言创建路线
🗑️ 路线删除：删除经过安全验证的路线
🔧 网关侦听器管理：添加/删除端口和协议
⚡ 生成应用验证模式：可靠的写入操作

🎯 高级交通控制

📊 交通分流：Canary部署，基于百分比的流量分布
⚖️ 负载平衡：配置策略（轮询、最小请求、随机、环哈希、磁悬浮）
🏥 健康检查：后端服务运行状况监视配置
🛡️ 交通政策：速率限制、身份验证、CORS和超时策略

🛡️ 安全生产

🔒 只读模式：无修改风险的安全监控
🧪 干运行模式：生成YAML清单而不应用
✅ 全面验证：符合RFC 1123的资源名称、主机名、端口
🚫 冲突预防：通过智能检查进行重复资源检测
🔐 RBAC错误处理：清除权限错误消息，并提供故障排除指南
🏷️ 资源标签：跟踪EGMCP管理的资源以进行审计跟踪
⚡ 输入消毒：在模拟运行和实时模式下进行实时验证

⚡ 增强功能

🎛️ 多环境支持：生产、分期、开发配置
🧪 边缘案例处理：用于生产的强大错误处理
📈 性能优化：使用Claude Desktop测试响应能力
🔄 Kubernetes集成：完整网关API资源CRUD操作

🎬 观看演示

查看这段YouTube短片，快速演示EGMCP服务器的运行情况：

![EGMCP Server Demo](https://www.youtube.com/shorts/C-Fakrx3fUQ)

*注意：演示显示了Sprint 2的功能。当前版本包括全面的路线管理和先进的交通控制！*

📖 文档

📚 完整的用户指南 -全面的安装、配置和使用文档

🚀 快速开始

1.安装EGMCP服务器

选项A:NPX安装（推荐-无需安装）

# Test the server directly
npx @saptak/egmcp-server stdio-tools --envoy-url http://localhost:19001

# With Kubernetes support for write operations
npx @saptak/egmcp-server stdio-tools --envoy-url http://localhost:19001 --kubernetes.kubeconfig ~/.kube/config

对于Claude Desktop，配置如下：

{
  "mcpServers": {
    "egmcp-server": {
      "command": "npx",
      "args": [
        "@saptak/egmcp-server",
        "stdio-tools",
        "--envoy-url",
        "http://localhost:19001",
        "--kubernetes.kubeconfig",
        "/Users/yourname/.kube/config"
      ],
      "env": {}
    }
  }
}

对于只读监控：

{
  "mcpServers": {
    "egmcp-server": {
      "command": "npx",
      "args": [
        "@saptak/egmcp-server",
        "stdio-tools",
        "--envoy-url",
        "http://localhost:19001",
        "--kubernetes.kubeconfig",
        "/Users/yourname/.kube/config",
        "--kubernetes.read_only"
      ],
      "env": {}
    }
  }
}

对于GitOps开发（模拟运行模式）：

{
  "mcpServers": {
    "egmcp-server": {
      "command": "npx",
      "args": [
        "@saptak/egmcp-server",
        "stdio-tools",
        "--envoy-url",
        "http://localhost:19001",
        "--kubernetes.dry_run"
      ],
      "env": {}
    }
  }
}

选项B：二进制安装

curl -sSL https://raw.githubusercontent.com/saptak/eg-mcp-server/main/install.sh | bash

2.设置Envoy网关访问

# Automated setup
curl -sSL https://raw.githubusercontent.com/saptak/eg-mcp-server/main/setup-envoy.sh | bash

# Manual setup
kubectl get pods -n envoy-gateway-system
kubectl port-forward -n envoy-gateway-system pod/YOUR_ENVOY_POD 19001:19000

3.重新启动克劳德桌面

Claude Desktop将自动加载EGMCP服务器并使所有工具可用。

🛠️ 可用工具

可用工具概述

EGMCP服务器提供 11种专用工具 全面的Envoy网关管理：

只读监控工具（4个工具）

听众：发现所有侦听器及其配置
路线：分析流量路由和虚拟主机
集群：列出后端服务和集群
总结：快速配置概述和运行状况

写入操作工具（3个工具）

路线创建：通过自然语言创建HTTPRoute资源
路线删除：通过安全验证删除现有路线
听众管理：添加/删除网关侦听器（端口/协议）

高级交通控制（4个工具）

交通分流：基于百分比分布的Canary部署
负载平衡：配置策略（循环、最小请求等）
健康检查：后端服务监控配置
交通政策：速率限制、身份验证、CORS、超时

📖 有关详细的工具文档、参数、示例和安全功能，请参阅完整的用户指南.

💬 查询示例

安装后，您可以询问Claude Desktop：

配置分析和监控

*“我的特使网关的当前状态如何？”*
*“显示Envoy Gateway中的所有侦听器”*
*“分析我的流量路由配置”*
*“列出所有可用的后端服务”*
*“给我一个网关配置摘要”*

路线管理

*“在API.example.com上为我的API服务创建一个路由，该路由将流量发送到API-service端口8080”*
*“为users.example.com添加一个名为user-api的新路由，指向用户服务：3000”*
*“删除名为测试路由的路由”*
*“为我的网关添加HTTPS支持”*
*“从网关中删除端口8080上的侦听器”*

高级交通控制

*“将20%的流量从api-v1转移到api-v2进行金丝雀测试”*
*“为主网关侦听器配置轮询负载平衡”*
*“以30秒的间隔为用户api路由设置健康检查”*
*“对api路由应用每秒100个请求的速率限制”*
*“为允许example.com来源的前端路由启用CORS”*
*“将JWT身份验证添加到管理路由”*

模拟运行模式和GitOps

*“为新路由生成YAML清单，而不应用它”*
*“显示在不应用流量分流的情况下会做出哪些更改”*
*“预览用于向我的路线添加健康检查的YAML”*
*“在部署前以模拟运行模式运行以验证配置”*

高级路由配置

*“在payments.app.com的生产命名空间中创建一个指向paymentsvc:8080的路由，路径为/api/v1”*
*“在端口443上向演示网关添加HTTPS侦听器”*
*“显示所有路线，然后为我的服务创建一条新路线”*
*“逐步将10%的用户流量转移到新的推荐服务”*

故障排除

*“检查端口8080上是否有侦听器”*
*“查找指向产品服务集群的路线”*
*“https_listener的配置是什么？”*
*“为什么流量没有到达我的服务？”*

📋 系统要求

基本要求

操作系统：macOS、Linux、Windows
克劳德桌面：支持MCP的最新版本
Envoy网关：启用管理员API的任何版本
网络接入：端口转发或直接访问Envoy网关管理员API

用于写入操作

Kubernetes访问：kubectl配置和权限
网关API：安装了网关API CRD的Kubernetes集群
RBAC权限：创建/修改HTTPRoute和网关资源的访问权限

可选的

去：1.21+（用于从源代码构建）

🔧 配置

关键配置选项

--envoy-url：Envoy网关管理员API URL
--kubernetes.kubeconfig：kubeconfig文件的路径
--kubernetes.read_only：启用只读模式（生产安全）
--kubernetes.dry_run：启用模拟运行模式（生成清单而不应用）
--kubernetes.default_namespace：操作的默认命名空间
--log-level：记录详细信息（调试、信息、警告、错误）

快速配置示例

生产监控（只读）

{
  "args": [
    "stdio-tools", 
    "--envoy-url", "http://prod-envoy:19001",
    "--kubernetes.kubeconfig", "/etc/kubernetes/prod-config",
    "--kubernetes.read_only"
  ]
}

GitOps开发（模拟运行模式）

{
  "args": [
    "stdio-tools", 
    "--envoy-url", "http://localhost:19001",
    "--kubernetes.dry_run"
  ]
}

📖 有关完整的配置选项、环境变量、多环境设置和详细示例，请参阅配置指南.

🚨 故障排除

快速修复

“无法连接到MCP服务器”

✅ 检查二进制路径是否为绝对路径： /usr/local/bin/egmcp-server
✅ 配置更改后重新启动Claude Desktop
✅ 验证kubeconfig路径是否存在并且可以访问

与Envoy网关的“连接被拒绝”

✅ 运行自动安装程序： curl -sSL https://raw.githubusercontent.com/saptak/eg-mcp-server/main/setup-envoy.sh | bash
✅ 测试连接性： curl http://localhost:19001/ready

写操作的“权限被拒绝”

✅ 使用只读模式进行监控： --kubernetes.read_only
✅ 检查kubectl访问权限： kubectl get httproutes

“路由创建失败，出现验证错误”

✅ 资源名称：仅使用小写、数字和连字符(api-service ✅, Api_Service ❌)
✅ 主机名：有效的DNS格式(api.example.com ✅, invalid hostname ❌)
✅ 港口：必须为1-65535（8080✅, 70000❌)

测试与调试

# Health check
egmcp-server health --envoy-url http://localhost:19001

# Debug mode
egmcp-server stdio-tools --log-level debug --envoy-url http://localhost:19001

# Test read-only mode
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "create_http_route", "arguments": {"name": "test", "gateway_name": "demo", "hostname": "test.local", "service_name": "svc", "service_port": 8080}}}' | \
  egmcp-server stdio-tools --kubernetes.read_only

📖 有关全面的故障排除、详细的错误解决方案、验证示例和测试程序，请参阅完整的故障排除指南.

🤝 贡献

我们欢迎捐款！

问题和功能请求: https://github.com/saptak/eg-mcp-server/issues

📄 许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

🆘 支持

GitHub问题: 报告错误和请求功能
完整的文件: 用户指南

______________________________________________________________________

准备好使用Claude Desktop增强您的Envoy网关管理了吗？开始使用NPX，体验先进交通控制的力量！ 🚀

EGMCP服务器新手？ 查看综合用户指南了解详细的示例和用例。

目录标签

ShellClaude自然语言查询本地部署服务网格管理流量控制Envoy网关Kubernetes集成

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

运行时（runtime，运行环境）

Node.js

来源包（packageName，安装包名）

@saptak/egmcp-server

工具数量（toolCount，工具数）

11

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/3f89211d9fff98081a7b9c89caa6c82d

EGMCP Server是一个生产就绪的MCP服务器，为Claude Desktop提供对Envoy Gateway配置、监控和完整流量管理功能的全面访问，支持高级流量控制功能。

继续浏览同类 MCP

更多开发工具 MCP（20,396）返回 MCP 目录

上一个 MCP

Egeokt MCP

MCP server that allows you to get the latest documentation

下一个 MCP

Egor Baranov MCP

全面解析MCP Agent ServersMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，MCP Agent Servers能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

Eg MCP Server