🧠 MCP Server Helm Chart

🧠 MCP 服务 Helm Chart

此 Helm Chart 可动态部署 MCP（Model Context Protocol） 服务，并通过 Server-Sent Events（SSE） 远程访问。它能让你轻松地将应用中现有的任何 REST API 暴露为 MCP 环境中的工具，供智能 Agent 或外部客户端查询和使用。

---

🚀 功能

• 在 Kubernetes 集群中部署 MCP 服务
• 通过 SSE 启用远程交互
• 动态注册 API 端点并将其暴露为 tools
• 通过 values.yaml 进行轻量级配置
• 兼容 FastAPI、Express、Flask 及任何 REST 服务

---

📦 Chart 结构

mcp-server/
├── Chart.yaml
├── values.yaml
└── templates/
    ├── deployment.yaml
    ├── service.yaml
    ├── ingressroute.yaml
    └── configmap.yaml

---

⚙️ 动态配置

你可以使用 config.tools 部分，直接在 values.yaml 文件中定义要暴露的 API。以下是一个配置示例：

config:
  tools: |
    tools:
      get_api_status:
        endpoint: https://api-users.dev.example.com/
        description: Get root message to verify the API is running.

      fetch_user_by_id:
        endpoint: https://api-users.dev.example.com/users/1
        description: Fetch a specific user by ID from the API.

      get_random_user:
        endpoint: https://api-users.dev.example.com/users/random
        description: Retrieve a randomly selected user (for testing/demo).

🔒 请将 *.dev.example.com 替换为你的实际域名。

---

🧪 安装 Chart

helm install mcp-server ./mcp-server \
  --values values.yaml

---

🔌 MCP 客户端配置

部署完成后，客户端可以使用以下配置连接到 MCP 服务：

{
  "mcp": {
    "servers": {
      "users-api": {
        "url": "https://mcp-server.dev.example.com/sse"
      }
    }
  }
}

🔁 MCP 服务使用 SSE（/sse）实时传输消息。

---

🧹 卸载

helm uninstall mcp-server

---

🧠 关于 MCP

MCP（Model Context Protocol）是一种轻量级交互层，可让智能 Agent 或应用通过自然语言界面或直接 API 查询来访问特定领域的工具。

---

📬 问题 / 贡献

欢迎提交 issue 或 pull request。欢迎贡献！