Local bridge templateDevOpsJan 1, 20260 calls

Kubernetes Local Bridge Template

Local-bridge template for pods, deployments, and logs. Astrail cloud does not load arbitrary kubeconfigs; run a local MCP bridge against your cluster.

Credential setup

local-bridge

This template is not executable on Astrail cloud. Use a local MCP bridge with access to the host runtime, then point your agent client at that local endpoint.

Install a local Kubernetes MCP server with a least-privilege kubeconfig on your machine or CI runner, then point your agent at that local endpoint.

CLI: astrail connectors describe preset-kubernetes

Hosted MCP endpoint

/api/mcp/preset-kubernetes

Private servers require an Astrail API key in the Authorization header.

MCP client snippets

Connect

Claude Desktop config

{
  "mcpServers": {
    "kubernetes-local-bridge-template": {
      "url": "/api/mcp/preset-kubernetes"
    }
  }
}

cURL initialize

curl -sS -X POST "/api/mcp/preset-kubernetes" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

cURL tools/list

curl -sS -X POST "/api/mcp/preset-kubernetes" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

cURL tools/call

curl -sS -X POST "/api/mcp/preset-kubernetes" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"kubernetes_list_pods","arguments":{"namespace":"example","selector":"example"}}}'

Runtime behavior

Runtime healthneeds_mapping

Endpoint healthnot_checked

Execution modemapping_required

Deterministic executionNot yet executable

Generated sourceExport only

Endpoint mapRequired

Endpoint mappedNo

Auth-required endpointsNone detected

Browser runtime endpointsNone detected

Last statusnot recorded

Last execution modenot recorded

Last toolnot recorded

Last latencynot recorded

Upstream statusnot recorded

Trace IDnot recorded

Error codenone

Observabilitystructured fallback

Rate limit modestandard

Missing authauth_required / oauth_required

Missing mappingmapping_required

Astrail does not evaluate generated TypeScript inside Next.js. Hosted calls are routed through stored tool metadata and endpoint maps.

Tools

kubernetes_list_pods

List pods by namespace and labels via a local Kubernetes bridge.

kubernetes_get_logs

Fetch pod logs via a local Kubernetes bridge.

kubernetes_rollout_status

Check rollout status for a deployment via a local Kubernetes bridge.

server.ts

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "Kubernetes Local Bridge Template", version: "1.0.0" });

// Curated Astrail local-bridge template for: kubernetes_list_pods, kubernetes_get_logs, kubernetes_rollout_status.
// This is a local-bridge template. Astrail does not host Docker sockets or Kubernetes API access from its cloud runtime. Run a local MCP bridge and point your client at that endpoint.

server.tool("connector_status", "Confirm this curated connector template is installed.", z.object({}), async () => ({
  content: [{ type: "text", text: "Local-bridge template only. Install a local Docker/Kubernetes MCP bridge; Astrail cloud runtime will not open host sockets or kubeconfigs." }],
}));

const transport = new StdioServerTransport();
await server.connect(transport);