KubeBuddy MCP Server<\/title>\n <link rel=\"stylesheet\" href=\"\/wp-content\/plugins\/kubebuddy-radar-plugin\/assets\/radar.css\">\n <link rel=\"stylesheet\" href=\"\/wp-content\/plugins\/kubebuddy-radar-plugin\/assets\/docs.css?v=5\">\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/prism.min.js\"><\/script>\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/components\/prism-bash.min.js\"><\/script>\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/components\/prism-json.min.js\"><\/script>\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/components\/prism-python.min.js\"><\/script>\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/components\/prism-powershell.min.js\"><\/script>\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/components\/prism-javascript.min.js\"><\/script>\n<\/head>\n<body>\n <div class=\"kb-docs-page\">\n <div class=\"kb-docs-hero\">\n <a class=\"kb-docs-back\" href=\"\/docs\/\">\u2190 Back to Docs<\/a>\n <h1>KubeBuddy MCP Server<\/h1>\n <p>Model Context Protocol bridge that lets AI agents like Claude Desktop, Cursor, or Windsurf query the KubeBuddy Radar API with natural language. Access 286+ CNCF projects, release notes, security tracking, and your personal dashboard.<\/p>\n <p><a href=\"\/docs\/api\/\">View the API reference<\/a> ↗<\/p>\n <\/div>\n\n <div class=\"kb-docs-content\">\n <section id=\"what-is-this\" class=\"kb-docs-section\">\n <h2>What is this?<\/h2>\n <p>The KubeBuddy MCP Server connects AI assistants like Claude Desktop to the KubeBuddy Radar API, letting you ask natural language questions about CNCF projects, releases, and security updates.<\/p>\n <p>Simply install the server, configure your AI assistant, and start asking questions like “What’s the latest Kubernetes version?” or “Show me recent security releases.”<\/p>\n <\/section>\n\n <section id=\"quick-start\" class=\"kb-docs-section\">\n <h2>Quick Start<\/h2>\n \n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"quick-start-npm\">Copy<\/button>\n <pre id=\"quick-start-npm\"><code class=\"language-bash\">npm install -g @kubedeck\/kubebuddy-radar-mcp<\/code><\/pre>\n <\/div>\n \n <p>After installation, configure your AI assistant to use the MCP server.<\/p>\n <\/section>\n\n <section id=\"configuration\" class=\"kb-docs-section\">\n <h2>Configuration<\/h2>\n <h3>Claude Desktop<\/h3>\n <p>Edit <code>%APPDATA%\\Claude\\claude_desktop_config.json<\/code> (Windows) or <code>~\/Library\/Application Support\/Claude\/claude_desktop_config.json<\/code> (macOS) and add:<\/p>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"claude-config\">Copy<\/button>\n <pre id=\"claude-config\"><code class=\"language-json\">{\n \"mcpServers\": {\n \"kubebuddy-radar\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@kubedeck\/kubebuddy-radar-mcp\"\n ]\n }\n }\n}<\/code><\/pre>\n <\/div>\n <p>Restart Claude Desktop to activate the server. You can then ask natural language questions like “What are the most popular CNCF projects?” or “Show me recent security releases.”<\/p>\n \n <h3>Release & Packaging<\/h3>\n <p>We publish <code>@kubedeck\/kubuddy-radar-mcp<\/code> via the <code>kubebuddy-radar-mcp\/.github\/workflows\/mcp-release.yml<\/code> workflow. Before a release, bump the version in <code>kubebuddy-radar-mcp\/package.json<\/code>, run <code>npm pack<\/code>, and trigger the workflow (manually or via a GitHub Release) so it uploads the generated <code>kubebuddy-radar-mcp-*.tgz<\/code> artifact.<\/p>\n <p>Set the <code>NPM_TOKEN<\/code> secret with publish rights so the action can log into <code>https:\/\/registry.npmjs.org<\/code> and run <code>npm publish --access public<\/code>. Consumers can install the package with <code>npm install -g @kubedeck\/kubuddy-radar-mcp<\/code> or the dynamic <code>npx -y @kubedeck\/kubuddy-radar-mcp<\/code> command.<\/p>\n \n <h3>VS Code with GitHub Copilot<\/h3>\n <p>Edit your VS Code MCP settings (<code>%APPDATA%\\Code\\User\\profiles\\<profile-id>\\mcp.json<\/code> on Windows):<\/p>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"vscode-config\">Copy<\/button>\n <pre id=\"vscode-config\"><code class=\"language-json\">{\n \"mcpServers\": {\n \"kubebuddy-radar\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@kubedeck\/kubebuddy-radar-mcp\"\n ]\n }\n }\n}<\/code><\/pre>\n <\/div>\n <p>Restart VS Code to activate the server.<\/p>\n <\/section>\n\n <section id=\"authentication\" class=\"kb-docs-section\">\n <h2>Authentication<\/h2>\n <p>Private endpoints (<code>get_my_dashboard<\/code> and <code>get_my_subscriptions<\/code>) require your WordPress username and an Application Password created under <strong>Account \u2192 Developer API access<\/strong> on the KubeBuddy Radar website.<\/p>\n \n <h3>Secure Setup (Recommended)<\/h3>\n <p>Set environment variables on your system to securely store your credentials:<\/p>\n \n <h4>Windows (PowerShell)<\/h4>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"env-windows\">Copy<\/button>\n <pre id=\"env-windows\"><code class=\"language-powershell\"># Set for current session\n$env:KUBEBUDDY_USERNAME = \"your-username\"\n$env:KUBEBUDDY_APP_PASSWORD = \"xxxx xxxx xxxx xxxx xxxx xxxx\"\n\n# Set permanently (requires restart of Claude\/VS Code)\n[System.Environment]::SetEnvironmentVariable('KUBEBUDDY_USERNAME', 'your-username', 'User')\n[System.Environment]::SetEnvironmentVariable('KUBEBUDDY_APP_PASSWORD', 'xxxx xxxx xxxx xxxx xxxx xxxx', 'User')<\/code><\/pre>\n <\/div>\n \n <h4>macOS\/Linux (Bash\/Zsh)<\/h4>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"env-unix\">Copy<\/button>\n <pre id=\"env-unix\"><code class=\"language-bash\"># Add to ~\/.bashrc or ~\/.zshrc for permanent setup\nexport KUBEBUDDY_USERNAME=\"your-username\"\nexport KUBEBUDDY_APP_PASSWORD=\"xxxx xxxx xxxx xxxx xxxx xxxx\"\n\n# Then reload your shell or restart your AI assistant<\/code><\/pre>\n <\/div>\n \n <p>Once environment variables are set, authenticated tools work automatically without exposing credentials in chat logs or config files.<\/p>\n \n <h3>Alternative: Config File (Less Secure)<\/h3>\n <p>If you prefer, you can add credentials directly to your MCP config file, though this stores them in plain text:<\/p>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"auth-config\">Copy<\/button>\n <pre id=\"auth-config\"><code class=\"language-json\">{\n \"mcpServers\": {\n \"kubebuddy-radar\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@kubedeck\/kubebuddy-radar-mcp\"],\n \"env\": {\n \"KUBEBUDDY_USERNAME\": \"your-username\",\n \"KUBEBUDDY_APP_PASSWORD\": \"xxxx xxxx xxxx xxxx xxxx xxxx\"\n }\n }\n }\n}<\/code><\/pre>\n <\/div>\n <\/section>\n\n <section id=\"available-tools\" class=\"kb-docs-section\">\n <h2>Available Tools<\/h2>\n <p>The MCP server exposes 9 tools. All tools require authentication via your KubeBuddy Radar API credentials.<\/p>\n \n <h3>Catalog Tools (Auth Required)<\/h3>\n <table class=\"kb-docs-table\">\n <thead>\n <tr>\n <th>Tool<\/th>\n <th>Description<\/th>\n <\/tr>\n <\/thead>\n <tbody>\n <tr>\n <td><code>search_projects<\/code><\/td>\n <td>Search 286+ CNCF projects by name (exact matches prioritized), description, category, or repo URL. Filter by CNCF status (graduated\/incubating\/sandbox\/open-source). Returns paginated results with project details.<\/td>\n <\/tr>\n <tr>\n <td><code>get_project_by_name<\/code><\/td>\n <td>Quick lookup to find a project by exact or partial name. Returns the single best match with full details. Perfect for “What’s the latest Kubernetes version?” queries. 1-step instead of 3.<\/td>\n <\/tr>\n <tr>\n <td><code>get_recent_releases<\/code><\/td>\n <td>Get latest stable releases across all projects. Filter by category (CI\/CD, Networking, Storage, etc.) or show only security releases. Includes AI-parsed release notes, CVE information, and severity levels. Max 20 results.<\/td>\n <\/tr>\n <tr>\n <td><code>get_stats<\/code><\/td>\n <td>Platform statistics: total projects tracked, total releases, release counts by time period (7d\/30d\/90d), security fix counts, and CNCF project distribution (graduated\/incubating\/sandbox).<\/td>\n <\/tr>\n <tr>\n <td><code>get_project<\/code><\/td>\n <td>Fetch detailed information about a single project by ID. Returns metadata (name, description, category, CNCF status), subscriber count, and latest release with security info.<\/td>\n <\/tr>\n <tr>\n <td><code>get_project_releases<\/code><\/td>\n <td>Retrieve release history for a project, grouped by type: “app” (stable), “helm” (Helm charts), or “pre” (pre-releases). Includes CVEs, AI-parsed release notes, breaking changes, and key features.<\/td>\n <\/tr>\n <tr>\n <td><code>get_popular_projects<\/code><\/td>\n <td>Most popular projects ranked by subscriber count. Shows release activity (releases in last 30 days) and subscriber counts for discovering widely-used projects.<\/td>\n <\/tr>\n <\/tbody>\n <\/table>\n\n <h3>User Tools (Authentication Required)<\/h3>\n <table class=\"kb-docs-table\">\n <thead>\n <tr>\n <th>Tool<\/th>\n <th>Description<\/th>\n <\/tr>\n <\/thead>\n <tbody>\n <tr>\n <td><code>get_my_dashboard<\/code><\/td>\n <td>Your personal dashboard with all subscriptions, Pro membership status, subscription limits, webhook settings, and custom labels. Requires Kubebuddy Radar credentials.<\/td>\n <\/tr>\n <tr>\n <td><code>get_my_subscriptions<\/code><\/td>\n <td>Detailed subscription list with project metadata, latest releases, webhook configurations, and notification settings per subscription. Requires authentication.<\/td>\n <\/tr>\n <\/tbody>\n <\/table>\n <\/section>\n\n <section id=\"features\" class=\"kb-docs-section\">\n <h2>Key Features<\/h2>\n <ul>\n <li><strong>Quick Project Lookups<\/strong>: <code>get_project_by_name<\/code> tool finds projects in 1 step instead of 3<\/li>\n <li><strong>CNCF Maturity Filtering<\/strong>: Filter projects by graduation status (graduated\/incubating\/sandbox) to find production-ready or emerging tools<\/li>\n <li><strong>Category Filtering<\/strong>: Filter recent releases by category (CI\/CD, Networking, Storage, Security, Observability, etc.)<\/li>\n <li><strong>Security-Only Mode<\/strong>: View only releases with security fixes for focused security monitoring<\/li>\n <li><strong>Security Tracking<\/strong>: All releases include security fix flags, CVE lists, severity levels (critical\/high\/medium\/low), and security summaries<\/li>\n <li><strong>AI-Parsed Release Notes<\/strong>: Every release has AI-generated summaries with key features, breaking changes, and good-to-know information<\/li>\n <li><strong>CNCF Project Catalog<\/strong>: Track 286+ projects with CNCF graduation status<\/li>\n <li><strong>Smart Search<\/strong>: Server-side search with prioritized results (exact name matches first, then partial matches)<\/li>\n <li><strong>Release Type Filtering<\/strong>: Filter by stable releases (app), Helm charts (helm), or pre-releases (pre)<\/li>\n <li><strong>Project Categories<\/strong>: Organized by category (CI\/CD, Networking, Storage, Security, Observability, etc.)<\/li>\n <li><strong>Popularity Metrics<\/strong>: See subscriber counts and release activity (releases in last 30 days)<\/li>\n <li><strong>Flexible Schema Validation<\/strong>: Automatically handles WordPress API inconsistencies (string IDs, mixed boolean types, null values)<\/li>\n <li><strong>Production-Ready<\/strong>: Tested against live API, handles all edge cases and data type variations<\/li>\n <\/ul>\n <\/section>\n\n <section id=\"example-queries\" class=\"kb-docs-section\">\n <h2>Example Natural Language Queries<\/h2>\n <p>Once configured, you can ask your AI assistant questions like:<\/p>\n \n <h3>Security & Vulnerabilities<\/h3>\n <ul>\n <li>“What are the latest security releases?”<\/li>\n <li>“Show me critical security fixes from this week”<\/li>\n <li>“Show me only security releases from the last 20 releases”<\/li>\n <li>“Are there any CVEs in the latest Kubernetes release?”<\/li>\n <li>“Which projects have security vulnerabilities?”<\/li>\n <\/ul>\n\n <h3>Version & Release Information<\/h3>\n <ul>\n <li>“What’s the latest version of ArgoCD?”<\/li>\n <li>“What’s the latest Kubernetes version?”<\/li>\n <li>“Show me recent releases for CI\/CD tools”<\/li>\n <li>“What breaking changes are in the new Prometheus release?”<\/li>\n <li>“Show me Helm chart releases for Cilium”<\/li>\n <li>“What’s new in the latest Envoy release?”<\/li>\n <\/ul>\n \n <h3>Category-Specific Releases<\/h3>\n <ul>\n <li>“Show me recent CI\/CD tool releases”<\/li>\n <li>“What networking projects have released recently?”<\/li>\n <li>“Show me the latest storage solution updates”<\/li>\n <li>“What service mesh releases are there?”<\/li>\n <li>“Show me recent monitoring tool releases”<\/li>\n <\/ul>\n \n <h3>CNCF Maturity Questions<\/h3>\n <ul>\n <li>“What are the CNCF graduated projects?”<\/li>\n <li>“Show me incubating CNCF projects”<\/li>\n <li>“Which sandbox projects are available?”<\/li>\n <li>“Find production-ready service mesh projects”<\/li>\n <li>“Show me mature monitoring tools”<\/li>\n <\/ul>\n\n <h3>Discovery & Comparison<\/h3>\n <ul>\n <li>“What are the most popular CNCF projects?”<\/li>\n <li>“Show me all service mesh projects”<\/li>\n <li>“What orchestration tools are available?”<\/li>\n <li>“Which monitoring tools have released recently?”<\/li>\n <li>“Find me the ArgoCD project details”<\/li>\n <\/ul>\n\n <h3>Platform Overview<\/h3>\n <ul>\n <li>“How many projects does KubeBuddy track?”<\/li>\n <li>“Show me platform statistics”<\/li>\n <li>“How many releases were published this month?”<\/li>\n <\/ul>\n <\/section>\n\n <section id=\"documentation\" class=\"kb-docs-section\">\n <h2>Documentation<\/h2>\n <ul>\n <li><a href=\"https:\/\/github.com\/KubeDeckio\/kubebuddy-radar-mcp\">MCP Server Repository<\/a> – GitHub repository with full source code and README<\/li>\n <li><a href=\"https:\/\/github.com\/KubeDeckio\/kubebuddy-radar-mcp\/blob\/main\/TESTING.md\">Testing Guide<\/a> – Comprehensive testing documentation with examples for all tools<\/li>\n <li><a href=\"\/docs\/api\/\">API Reference<\/a> – Full REST API documentation<\/li>\n <li><a href=\"https:\/\/modelcontextprotocol.io\">MCP Protocol Docs<\/a> – Official Model Context Protocol documentation<\/li>\n <\/ul>\n <\/section>\n\n <section id=\"troubleshooting\" class=\"kb-docs-section\">\n <h2>Troubleshooting<\/h2>\n \n <h3>Installation Issues<\/h3>\n <p><strong>Issue:<\/strong> npm install fails or package not found<\/p>\n <p><strong>Solution:<\/strong> Make sure you’re using the correct package name: <code>@kubedeck\/kubebuddy-radar-mcp<\/code>. If you continue to have issues, try clearing npm cache:<\/p>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"install-fix\">Copy<\/button>\n <pre id=\"install-fix\"><code class=\"language-bash\">npm cache clean --force\nnpm install -g @kubedeck\/kubebuddy-radar-mcp<\/code><\/pre>\n <\/div>\n \n <h3>Server Not Responding<\/h3>\n <p><strong>Issue:<\/strong> AI assistant can’t connect to the MCP server<\/p>\n <p><strong>Solution:<\/strong> If using npx, make sure you have an active internet connection for the first run. If using a global installation, verify the path in your config file is correct (typically <code>%APPDATA%\\Roaming\\npm\\node_modules\\@kubedeck\\kubebuddy-radar-mcp\\dist\\index.js<\/code> on Windows). Restart your AI assistant after any configuration changes.<\/p>\n \n <h3>Authentication Errors<\/h3>\n <p><strong>Issue:<\/strong> Getting 401 errors when accessing private endpoints<\/p>\n <p><strong>Solution:<\/strong> Verify your WordPress username and Application Password are correct. The format should be <code>username:app_password<\/code>.<\/p>\n \n <h3>Unexpected Results<\/h3>\n <p><strong>Issue:<\/strong> Search results or project information seem incorrect<\/p>\n <p><strong>Solution:<\/strong> Make sure you’re using the latest version: <code>npm update -g @kubedeck\/kubebuddy-radar-mcp<\/code>. If using npx, restart your AI assistant to pull the latest version.<\/p>\n\n <h3>Need Help?<\/h3>\n <p>Check the <a href=\"https:\/\/github.com\/KubeDeckio\/kubebuddy-radar-mcp\/blob\/main\/TESTING.md\">testing guide<\/a> or <a href=\"https:\/\/github.com\/KubeDeckio\/kubebuddy-radar-mcp\/issues\">open an issue on GitHub<\/a>.<\/p>\n <\/section>\n <\/div>\n <\/div>\n <script src=\"\/wp-content\/plugins\/kubebuddy-radar-plugin\/assets\/docs.js?v=5\"><\/script>\n<\/body>\n<\/html>\n\n","protected":false},"excerpt":{"rendered":"<p>KubeBuddy MCP Server \u2190 Back to Docs KubeBuddy MCP Server Model Context Protocol bridge that lets AI agents like Claude Desktop, Cursor, or Windsurf query the KubeBuddy Radar API with natural language. Access 286+ CNCF projects, release notes, security tracking, and your personal dashboard. View the API reference ↗ What is this? The KubeBuddy MCP … <a title=\"MCP Server\" class=\"read-more\" href=\"https:\/\/radar.kubebuddy.io\/docs\/mcp-server\/\" aria-label=\"Read more about MCP Server\">Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":608,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-727","page","type-page","status-publish"],"_links":{"self":[{"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/pages\/727","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/comments?post=727"}],"version-history":[{"count":12,"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/pages\/727\/revisions"}],"predecessor-version":[{"id":817,"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/pages\/727\/revisions\/817"}],"up":[{"embeddable":true,"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/pages\/608"}],"wp:attachment":[{"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/media?parent=727"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

{"id":727,"date":"2026-01-23T12:53:19","date_gmt":"2026-01-23T12:53:19","guid":{"rendered":"https:\/\/radar.kubebuddy.io\/?page_id=727"},"modified":"2026-01-25T21:34:38","modified_gmt":"2026-01-25T21:34:38","slug":"mcp-server","status":"publish","type":"page","link":"https:\/\/radar.kubebuddy.io\/docs\/mcp-server\/","title":{"rendered":"MCP Server"},"content":{"rendered":"\n\n\n\n \n \n KubeBuddy MCP Server<\/title>\n <link rel=\"stylesheet\" href=\"\/wp-content\/plugins\/kubebuddy-radar-plugin\/assets\/radar.css\">\n <link rel=\"stylesheet\" href=\"\/wp-content\/plugins\/kubebuddy-radar-plugin\/assets\/docs.css?v=5\">\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/prism.min.js\"><\/script>\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/components\/prism-bash.min.js\"><\/script>\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/components\/prism-json.min.js\"><\/script>\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/components\/prism-python.min.js\"><\/script>\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/components\/prism-powershell.min.js\"><\/script>\n <script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/prism\/1.29.0\/components\/prism-javascript.min.js\"><\/script>\n<\/head>\n<body>\n <div class=\"kb-docs-page\">\n <div class=\"kb-docs-hero\">\n <a class=\"kb-docs-back\" href=\"\/docs\/\">\u2190 Back to Docs<\/a>\n <h1>KubeBuddy MCP Server<\/h1>\n <p>Model Context Protocol bridge that lets AI agents like Claude Desktop, Cursor, or Windsurf query the KubeBuddy Radar API with natural language. Access 286+ CNCF projects, release notes, security tracking, and your personal dashboard.<\/p>\n <p><a href=\"\/docs\/api\/\">View the API reference<\/a> ↗<\/p>\n <\/div>\n\n <div class=\"kb-docs-content\">\n <section id=\"what-is-this\" class=\"kb-docs-section\">\n <h2>What is this?<\/h2>\n <p>The KubeBuddy MCP Server connects AI assistants like Claude Desktop to the KubeBuddy Radar API, letting you ask natural language questions about CNCF projects, releases, and security updates.<\/p>\n <p>Simply install the server, configure your AI assistant, and start asking questions like “What’s the latest Kubernetes version?” or “Show me recent security releases.”<\/p>\n <\/section>\n\n <section id=\"quick-start\" class=\"kb-docs-section\">\n <h2>Quick Start<\/h2>\n \n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"quick-start-npm\">Copy<\/button>\n <pre id=\"quick-start-npm\"><code class=\"language-bash\">npm install -g @kubedeck\/kubebuddy-radar-mcp<\/code><\/pre>\n <\/div>\n \n <p>After installation, configure your AI assistant to use the MCP server.<\/p>\n <\/section>\n\n <section id=\"configuration\" class=\"kb-docs-section\">\n <h2>Configuration<\/h2>\n <h3>Claude Desktop<\/h3>\n <p>Edit <code>%APPDATA%\\Claude\\claude_desktop_config.json<\/code> (Windows) or <code>~\/Library\/Application Support\/Claude\/claude_desktop_config.json<\/code> (macOS) and add:<\/p>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"claude-config\">Copy<\/button>\n <pre id=\"claude-config\"><code class=\"language-json\">{\n \"mcpServers\": {\n \"kubebuddy-radar\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@kubedeck\/kubebuddy-radar-mcp\"\n ]\n }\n }\n}<\/code><\/pre>\n <\/div>\n <p>Restart Claude Desktop to activate the server. You can then ask natural language questions like “What are the most popular CNCF projects?” or “Show me recent security releases.”<\/p>\n \n <h3>Release & Packaging<\/h3>\n <p>We publish <code>@kubedeck\/kubuddy-radar-mcp<\/code> via the <code>kubebuddy-radar-mcp\/.github\/workflows\/mcp-release.yml<\/code> workflow. Before a release, bump the version in <code>kubebuddy-radar-mcp\/package.json<\/code>, run <code>npm pack<\/code>, and trigger the workflow (manually or via a GitHub Release) so it uploads the generated <code>kubebuddy-radar-mcp-*.tgz<\/code> artifact.<\/p>\n <p>Set the <code>NPM_TOKEN<\/code> secret with publish rights so the action can log into <code>https:\/\/registry.npmjs.org<\/code> and run <code>npm publish --access public<\/code>. Consumers can install the package with <code>npm install -g @kubedeck\/kubuddy-radar-mcp<\/code> or the dynamic <code>npx -y @kubedeck\/kubuddy-radar-mcp<\/code> command.<\/p>\n \n <h3>VS Code with GitHub Copilot<\/h3>\n <p>Edit your VS Code MCP settings (<code>%APPDATA%\\Code\\User\\profiles\\<profile-id>\\mcp.json<\/code> on Windows):<\/p>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"vscode-config\">Copy<\/button>\n <pre id=\"vscode-config\"><code class=\"language-json\">{\n \"mcpServers\": {\n \"kubebuddy-radar\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@kubedeck\/kubebuddy-radar-mcp\"\n ]\n }\n }\n}<\/code><\/pre>\n <\/div>\n <p>Restart VS Code to activate the server.<\/p>\n <\/section>\n\n <section id=\"authentication\" class=\"kb-docs-section\">\n <h2>Authentication<\/h2>\n <p>Private endpoints (<code>get_my_dashboard<\/code> and <code>get_my_subscriptions<\/code>) require your WordPress username and an Application Password created under <strong>Account \u2192 Developer API access<\/strong> on the KubeBuddy Radar website.<\/p>\n \n <h3>Secure Setup (Recommended)<\/h3>\n <p>Set environment variables on your system to securely store your credentials:<\/p>\n \n <h4>Windows (PowerShell)<\/h4>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"env-windows\">Copy<\/button>\n <pre id=\"env-windows\"><code class=\"language-powershell\"># Set for current session\n$env:KUBEBUDDY_USERNAME = \"your-username\"\n$env:KUBEBUDDY_APP_PASSWORD = \"xxxx xxxx xxxx xxxx xxxx xxxx\"\n\n# Set permanently (requires restart of Claude\/VS Code)\n[System.Environment]::SetEnvironmentVariable('KUBEBUDDY_USERNAME', 'your-username', 'User')\n[System.Environment]::SetEnvironmentVariable('KUBEBUDDY_APP_PASSWORD', 'xxxx xxxx xxxx xxxx xxxx xxxx', 'User')<\/code><\/pre>\n <\/div>\n \n <h4>macOS\/Linux (Bash\/Zsh)<\/h4>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"env-unix\">Copy<\/button>\n <pre id=\"env-unix\"><code class=\"language-bash\"># Add to ~\/.bashrc or ~\/.zshrc for permanent setup\nexport KUBEBUDDY_USERNAME=\"your-username\"\nexport KUBEBUDDY_APP_PASSWORD=\"xxxx xxxx xxxx xxxx xxxx xxxx\"\n\n# Then reload your shell or restart your AI assistant<\/code><\/pre>\n <\/div>\n \n <p>Once environment variables are set, authenticated tools work automatically without exposing credentials in chat logs or config files.<\/p>\n \n <h3>Alternative: Config File (Less Secure)<\/h3>\n <p>If you prefer, you can add credentials directly to your MCP config file, though this stores them in plain text:<\/p>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"auth-config\">Copy<\/button>\n <pre id=\"auth-config\"><code class=\"language-json\">{\n \"mcpServers\": {\n \"kubebuddy-radar\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@kubedeck\/kubebuddy-radar-mcp\"],\n \"env\": {\n \"KUBEBUDDY_USERNAME\": \"your-username\",\n \"KUBEBUDDY_APP_PASSWORD\": \"xxxx xxxx xxxx xxxx xxxx xxxx\"\n }\n }\n }\n}<\/code><\/pre>\n <\/div>\n <\/section>\n\n <section id=\"available-tools\" class=\"kb-docs-section\">\n <h2>Available Tools<\/h2>\n <p>The MCP server exposes 9 tools. All tools require authentication via your KubeBuddy Radar API credentials.<\/p>\n \n <h3>Catalog Tools (Auth Required)<\/h3>\n <table class=\"kb-docs-table\">\n <thead>\n <tr>\n <th>Tool<\/th>\n <th>Description<\/th>\n <\/tr>\n <\/thead>\n <tbody>\n <tr>\n <td><code>search_projects<\/code><\/td>\n <td>Search 286+ CNCF projects by name (exact matches prioritized), description, category, or repo URL. Filter by CNCF status (graduated\/incubating\/sandbox\/open-source). Returns paginated results with project details.<\/td>\n <\/tr>\n <tr>\n <td><code>get_project_by_name<\/code><\/td>\n <td>Quick lookup to find a project by exact or partial name. Returns the single best match with full details. Perfect for “What’s the latest Kubernetes version?” queries. 1-step instead of 3.<\/td>\n <\/tr>\n <tr>\n <td><code>get_recent_releases<\/code><\/td>\n <td>Get latest stable releases across all projects. Filter by category (CI\/CD, Networking, Storage, etc.) or show only security releases. Includes AI-parsed release notes, CVE information, and severity levels. Max 20 results.<\/td>\n <\/tr>\n <tr>\n <td><code>get_stats<\/code><\/td>\n <td>Platform statistics: total projects tracked, total releases, release counts by time period (7d\/30d\/90d), security fix counts, and CNCF project distribution (graduated\/incubating\/sandbox).<\/td>\n <\/tr>\n <tr>\n <td><code>get_project<\/code><\/td>\n <td>Fetch detailed information about a single project by ID. Returns metadata (name, description, category, CNCF status), subscriber count, and latest release with security info.<\/td>\n <\/tr>\n <tr>\n <td><code>get_project_releases<\/code><\/td>\n <td>Retrieve release history for a project, grouped by type: “app” (stable), “helm” (Helm charts), or “pre” (pre-releases). Includes CVEs, AI-parsed release notes, breaking changes, and key features.<\/td>\n <\/tr>\n <tr>\n <td><code>get_popular_projects<\/code><\/td>\n <td>Most popular projects ranked by subscriber count. Shows release activity (releases in last 30 days) and subscriber counts for discovering widely-used projects.<\/td>\n <\/tr>\n <\/tbody>\n <\/table>\n\n <h3>User Tools (Authentication Required)<\/h3>\n <table class=\"kb-docs-table\">\n <thead>\n <tr>\n <th>Tool<\/th>\n <th>Description<\/th>\n <\/tr>\n <\/thead>\n <tbody>\n <tr>\n <td><code>get_my_dashboard<\/code><\/td>\n <td>Your personal dashboard with all subscriptions, Pro membership status, subscription limits, webhook settings, and custom labels. Requires Kubebuddy Radar credentials.<\/td>\n <\/tr>\n <tr>\n <td><code>get_my_subscriptions<\/code><\/td>\n <td>Detailed subscription list with project metadata, latest releases, webhook configurations, and notification settings per subscription. Requires authentication.<\/td>\n <\/tr>\n <\/tbody>\n <\/table>\n <\/section>\n\n <section id=\"features\" class=\"kb-docs-section\">\n <h2>Key Features<\/h2>\n <ul>\n <li><strong>Quick Project Lookups<\/strong>: <code>get_project_by_name<\/code> tool finds projects in 1 step instead of 3<\/li>\n <li><strong>CNCF Maturity Filtering<\/strong>: Filter projects by graduation status (graduated\/incubating\/sandbox) to find production-ready or emerging tools<\/li>\n <li><strong>Category Filtering<\/strong>: Filter recent releases by category (CI\/CD, Networking, Storage, Security, Observability, etc.)<\/li>\n <li><strong>Security-Only Mode<\/strong>: View only releases with security fixes for focused security monitoring<\/li>\n <li><strong>Security Tracking<\/strong>: All releases include security fix flags, CVE lists, severity levels (critical\/high\/medium\/low), and security summaries<\/li>\n <li><strong>AI-Parsed Release Notes<\/strong>: Every release has AI-generated summaries with key features, breaking changes, and good-to-know information<\/li>\n <li><strong>CNCF Project Catalog<\/strong>: Track 286+ projects with CNCF graduation status<\/li>\n <li><strong>Smart Search<\/strong>: Server-side search with prioritized results (exact name matches first, then partial matches)<\/li>\n <li><strong>Release Type Filtering<\/strong>: Filter by stable releases (app), Helm charts (helm), or pre-releases (pre)<\/li>\n <li><strong>Project Categories<\/strong>: Organized by category (CI\/CD, Networking, Storage, Security, Observability, etc.)<\/li>\n <li><strong>Popularity Metrics<\/strong>: See subscriber counts and release activity (releases in last 30 days)<\/li>\n <li><strong>Flexible Schema Validation<\/strong>: Automatically handles WordPress API inconsistencies (string IDs, mixed boolean types, null values)<\/li>\n <li><strong>Production-Ready<\/strong>: Tested against live API, handles all edge cases and data type variations<\/li>\n <\/ul>\n <\/section>\n\n <section id=\"example-queries\" class=\"kb-docs-section\">\n <h2>Example Natural Language Queries<\/h2>\n <p>Once configured, you can ask your AI assistant questions like:<\/p>\n \n <h3>Security & Vulnerabilities<\/h3>\n <ul>\n <li>“What are the latest security releases?”<\/li>\n <li>“Show me critical security fixes from this week”<\/li>\n <li>“Show me only security releases from the last 20 releases”<\/li>\n <li>“Are there any CVEs in the latest Kubernetes release?”<\/li>\n <li>“Which projects have security vulnerabilities?”<\/li>\n <\/ul>\n\n <h3>Version & Release Information<\/h3>\n <ul>\n <li>“What’s the latest version of ArgoCD?”<\/li>\n <li>“What’s the latest Kubernetes version?”<\/li>\n <li>“Show me recent releases for CI\/CD tools”<\/li>\n <li>“What breaking changes are in the new Prometheus release?”<\/li>\n <li>“Show me Helm chart releases for Cilium”<\/li>\n <li>“What’s new in the latest Envoy release?”<\/li>\n <\/ul>\n \n <h3>Category-Specific Releases<\/h3>\n <ul>\n <li>“Show me recent CI\/CD tool releases”<\/li>\n <li>“What networking projects have released recently?”<\/li>\n <li>“Show me the latest storage solution updates”<\/li>\n <li>“What service mesh releases are there?”<\/li>\n <li>“Show me recent monitoring tool releases”<\/li>\n <\/ul>\n \n <h3>CNCF Maturity Questions<\/h3>\n <ul>\n <li>“What are the CNCF graduated projects?”<\/li>\n <li>“Show me incubating CNCF projects”<\/li>\n <li>“Which sandbox projects are available?”<\/li>\n <li>“Find production-ready service mesh projects”<\/li>\n <li>“Show me mature monitoring tools”<\/li>\n <\/ul>\n\n <h3>Discovery & Comparison<\/h3>\n <ul>\n <li>“What are the most popular CNCF projects?”<\/li>\n <li>“Show me all service mesh projects”<\/li>\n <li>“What orchestration tools are available?”<\/li>\n <li>“Which monitoring tools have released recently?”<\/li>\n <li>“Find me the ArgoCD project details”<\/li>\n <\/ul>\n\n <h3>Platform Overview<\/h3>\n <ul>\n <li>“How many projects does KubeBuddy track?”<\/li>\n <li>“Show me platform statistics”<\/li>\n <li>“How many releases were published this month?”<\/li>\n <\/ul>\n <\/section>\n\n <section id=\"documentation\" class=\"kb-docs-section\">\n <h2>Documentation<\/h2>\n <ul>\n <li><a href=\"https:\/\/github.com\/KubeDeckio\/kubebuddy-radar-mcp\">MCP Server Repository<\/a> – GitHub repository with full source code and README<\/li>\n <li><a href=\"https:\/\/github.com\/KubeDeckio\/kubebuddy-radar-mcp\/blob\/main\/TESTING.md\">Testing Guide<\/a> – Comprehensive testing documentation with examples for all tools<\/li>\n <li><a href=\"\/docs\/api\/\">API Reference<\/a> – Full REST API documentation<\/li>\n <li><a href=\"https:\/\/modelcontextprotocol.io\">MCP Protocol Docs<\/a> – Official Model Context Protocol documentation<\/li>\n <\/ul>\n <\/section>\n\n <section id=\"troubleshooting\" class=\"kb-docs-section\">\n <h2>Troubleshooting<\/h2>\n \n <h3>Installation Issues<\/h3>\n <p><strong>Issue:<\/strong> npm install fails or package not found<\/p>\n <p><strong>Solution:<\/strong> Make sure you’re using the correct package name: <code>@kubedeck\/kubebuddy-radar-mcp<\/code>. If you continue to have issues, try clearing npm cache:<\/p>\n <div class=\"kb-docs-code\">\n <button class=\"kb-docs-copy\" data-copy-target=\"install-fix\">Copy<\/button>\n <pre id=\"install-fix\"><code class=\"language-bash\">npm cache clean --force\nnpm install -g @kubedeck\/kubebuddy-radar-mcp<\/code><\/pre>\n <\/div>\n \n <h3>Server Not Responding<\/h3>\n <p><strong>Issue:<\/strong> AI assistant can’t connect to the MCP server<\/p>\n <p><strong>Solution:<\/strong> If using npx, make sure you have an active internet connection for the first run. If using a global installation, verify the path in your config file is correct (typically <code>%APPDATA%\\Roaming\\npm\\node_modules\\@kubedeck\\kubebuddy-radar-mcp\\dist\\index.js<\/code> on Windows). Restart your AI assistant after any configuration changes.<\/p>\n \n <h3>Authentication Errors<\/h3>\n <p><strong>Issue:<\/strong> Getting 401 errors when accessing private endpoints<\/p>\n <p><strong>Solution:<\/strong> Verify your WordPress username and Application Password are correct. The format should be <code>username:app_password<\/code>.<\/p>\n \n <h3>Unexpected Results<\/h3>\n <p><strong>Issue:<\/strong> Search results or project information seem incorrect<\/p>\n <p><strong>Solution:<\/strong> Make sure you’re using the latest version: <code>npm update -g @kubedeck\/kubebuddy-radar-mcp<\/code>. If using npx, restart your AI assistant to pull the latest version.<\/p>\n\n <h3>Need Help?<\/h3>\n <p>Check the <a href=\"https:\/\/github.com\/KubeDeckio\/kubebuddy-radar-mcp\/blob\/main\/TESTING.md\">testing guide<\/a> or <a href=\"https:\/\/github.com\/KubeDeckio\/kubebuddy-radar-mcp\/issues\">open an issue on GitHub<\/a>.<\/p>\n <\/section>\n <\/div>\n <\/div>\n <script src=\"\/wp-content\/plugins\/kubebuddy-radar-plugin\/assets\/docs.js?v=5\"><\/script>\n<\/body>\n<\/html>\n\n","protected":false},"excerpt":{"rendered":"<p>KubeBuddy MCP Server \u2190 Back to Docs KubeBuddy MCP Server Model Context Protocol bridge that lets AI agents like Claude Desktop, Cursor, or Windsurf query the KubeBuddy Radar API with natural language. Access 286+ CNCF projects, release notes, security tracking, and your personal dashboard. View the API reference ↗ What is this? The KubeBuddy MCP … <a title=\"MCP Server\" class=\"read-more\" href=\"https:\/\/radar.kubebuddy.io\/docs\/mcp-server\/\" aria-label=\"Read more about MCP Server\">Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":608,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-727","page","type-page","status-publish"],"_links":{"self":[{"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/pages\/727","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/comments?post=727"}],"version-history":[{"count":12,"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/pages\/727\/revisions"}],"predecessor-version":[{"id":817,"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/pages\/727\/revisions\/817"}],"up":[{"embeddable":true,"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/pages\/608"}],"wp:attachment":[{"href":"https:\/\/radar.kubebuddy.io\/api\/wp\/v2\/media?parent=727"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}