{"id":49339752,"url":"https://github.com/citadel-cloud-management/mcp-server-kubernetes","last_synced_at":"2026-04-27T03:04:28.911Z","repository":{"id":345057567,"uuid":"1175451498","full_name":"Citadel-Cloud-Management/mcp-server-kubernetes","owner":"Citadel-Cloud-Management","description":"MCP server for Kubernetes operations - pods, deployments, services, logs, and scaling","archived":false,"fork":false,"pushed_at":"2026-04-11T22:18:45.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-12T00:34:32.822Z","etag":null,"topics":["ai","anthropic","claude","devops","k8s","kubernetes","llm","mcp","model-context-protocol","typescript"],"latest_commit_sha":null,"homepage":"https://citadel-cloud-management.github.io/mcp-server-kubernetes/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Citadel-Cloud-Management.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-07T18:21:40.000Z","updated_at":"2026-04-11T22:40:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Citadel-Cloud-Management/mcp-server-kubernetes","commit_stats":null,"previous_names":["kogunlowo123/mcp-server-kubernetes","citadel-cloud-management/mcp-server-kubernetes"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Citadel-Cloud-Management/mcp-server-kubernetes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Citadel-Cloud-Management%2Fmcp-server-kubernetes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Citadel-Cloud-Management%2Fmcp-server-kubernetes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Citadel-Cloud-Management%2Fmcp-server-kubernetes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Citadel-Cloud-Management%2Fmcp-server-kubernetes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Citadel-Cloud-Management","download_url":"https://codeload.github.com/Citadel-Cloud-Management/mcp-server-kubernetes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Citadel-Cloud-Management%2Fmcp-server-kubernetes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32320688,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","anthropic","claude","devops","k8s","kubernetes","llm","mcp","model-context-protocol","typescript"],"created_at":"2026-04-27T03:04:11.285Z","updated_at":"2026-04-27T03:04:28.897Z","avatar_url":"https://github.com/Citadel-Cloud-Management.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue?logo=typescript\u0026logoColor=white)\n![License](https://img.shields.io/badge/License-MIT-green)\n![GitHub release](https://img.shields.io/github/v/release/kogunlowo123/mcp-server-kubernetes)\n\n# mcp-server-kubernetes\n\nAn MCP (Model Context Protocol) server that provides tools for interacting with Kubernetes clusters, including pods, deployments, services, namespaces, events, and manifest management.\n\n## Architecture\n\n```mermaid\ngraph TB\n    subgraph Client\n        style Client fill:#4A90D9,stroke:#2E6BA6,color:#FFFFFF\n        MCP_Client[\"MCP Client\"]\n    end\n\n    subgraph Server[\"mcp-server-kubernetes\"]\n        style Server fill:#2ECC71,stroke:#1A9B52,color:#FFFFFF\n        Index[\"index.ts\u003cbr/\u003eMCP Server Entry\"]\n        subgraph Tools\n            style Tools fill:#F39C12,stroke:#C67D0A,color:#FFFFFF\n            T1[\"list_pods\"]\n            T2[\"list_deployments\"]\n            T3[\"list_services\"]\n            T4[\"get_pod_logs\"]\n            T5[\"apply_manifest\"]\n            T6[\"list_namespaces\"]\n            T7[\"get_events\"]\n            T8[\"scale_deployment\"]\n        end\n    end\n\n    subgraph K8s[\"Kubernetes Cluster\"]\n        style K8s fill:#326CE5,stroke:#1E4FA0,color:#FFFFFF\n        API[\"API Server\"]\n        subgraph Resources\n            style Resources fill:#E74C3C,stroke:#B83A2E,color:#FFFFFF\n            Pods[\"Pods\"]\n            Deploys[\"Deployments\"]\n            Svcs[\"Services\"]\n            NS[\"Namespaces\"]\n            Events[\"Events\"]\n        end\n    end\n\n    MCP_Client -- \"stdio transport\" --\u003e Index\n    Index --\u003e T1 \u0026 T2 \u0026 T3 \u0026 T4 \u0026 T5 \u0026 T6 \u0026 T7 \u0026 T8\n    T1 \u0026 T2 \u0026 T3 \u0026 T4 \u0026 T5 \u0026 T6 \u0026 T7 \u0026 T8 --\u003e API\n    API --\u003e Pods \u0026 Deploys \u0026 Svcs \u0026 NS \u0026 Events\n```\n\n## Installation\n\n```bash\nnpm install\nnpm run build\n```\n\n## Configuration\n\nThe server uses the default kubeconfig file (`~/.kube/config`) or in-cluster configuration when running inside Kubernetes.\n\n| Variable | Description | Required |\n|---|---|---|\n| `KUBECONFIG` | Path to kubeconfig file | No (defaults to `~/.kube/config`) |\n\n## Usage\n\n### Standalone\n\n```bash\nnpm start\n```\n\n### Development\n\n```bash\nnpm run dev\n```\n\n### Docker\n\n```bash\ndocker build -t mcp-server-kubernetes .\ndocker run -v ~/.kube/config:/root/.kube/config:ro mcp-server-kubernetes\n```\n\n### MCP Client Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"node\",\n      \"args\": [\"dist/index.js\"],\n      \"env\": {\n        \"KUBECONFIG\": \"/path/to/kubeconfig\"\n      }\n    }\n  }\n}\n```\n\n## Tool Reference\n\n| Tool | Description | Parameters |\n|---|---|---|\n| `list_pods` | List pods | `namespace?`, `label_selector?` |\n| `list_deployments` | List deployments | `namespace?` |\n| `list_services` | List services | `namespace?` |\n| `get_pod_logs` | Get pod logs | `namespace`, `pod_name`, `container?`, `tail_lines?` |\n| `apply_manifest` | Apply a K8s manifest | `manifest` (YAML string) |\n| `list_namespaces` | List namespaces | none |\n| `get_events` | Get cluster events | `namespace?` |\n| `scale_deployment` | Scale a deployment | `namespace`, `deployment_name`, `replicas` |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcitadel-cloud-management%2Fmcp-server-kubernetes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcitadel-cloud-management%2Fmcp-server-kubernetes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcitadel-cloud-management%2Fmcp-server-kubernetes/lists"}