{"id":29948655,"url":"https://github.com/kuadrant/kuadrant-mcp-walkthrough","last_synced_at":"2025-08-03T08:33:54.553Z","repository":{"id":302816525,"uuid":"1013196183","full_name":"Kuadrant/Kuadrant-MCP-Walkthrough","owner":"Kuadrant","description":"This is all the resources you would need to get all the Kuadrant MCP POC's up and running ","archived":false,"fork":false,"pushed_at":"2025-07-04T11:09:50.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-04T11:45:45.910Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kuadrant.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-03T14:00:35.000Z","updated_at":"2025-07-04T11:09:54.000Z","dependencies_parsed_at":"2025-07-05T13:30:56.481Z","dependency_job_id":null,"html_url":"https://github.com/Kuadrant/Kuadrant-MCP-Walkthrough","commit_stats":null,"previous_names":["kuadrant/kuadrant-mcp-walkthrough"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Kuadrant/Kuadrant-MCP-Walkthrough","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kuadrant%2FKuadrant-MCP-Walkthrough","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kuadrant%2FKuadrant-MCP-Walkthrough/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kuadrant%2FKuadrant-MCP-Walkthrough/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kuadrant%2FKuadrant-MCP-Walkthrough/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kuadrant","download_url":"https://codeload.github.com/Kuadrant/Kuadrant-MCP-Walkthrough/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kuadrant%2FKuadrant-MCP-Walkthrough/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268515144,"owners_count":24262566,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-03T02:00:12.545Z","response_time":2577,"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":[],"created_at":"2025-08-03T08:33:48.820Z","updated_at":"2025-08-03T08:33:54.533Z","avatar_url":"https://github.com/Kuadrant.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kuadrant-MCP-Walkthrough\nPrerequisites\n- A Kubernetes cluster \n- Kuadrant installed, please see the Kuadrant [docs](https://docs.kuadrant.io/latest/install-helm/) for more information.\n\n## Architecture\n\n```mermaid\nflowchart LR\n    C[MCP Client] --\u003e Gateway\n    E[Envoy/WASM] --\u003e G\n    G[MCP Gateway] --\u003e A[MCP Server 1]\n    G --\u003e B[MCP Server 2]\n    subgraph Gateway\n        direction TB\n        AP@{ shape: notch-rect, label: \"AuthPolicy\" } -.-\u003e E\n        RLP@{ shape: notch-rect, label: \"RateLimitPolicy\" } -.-\u003e E\n    end\n```\n\n## Deploy MCP Gateway aka MCP server(s)\n\nCreate the MCP Server namespace:\n\n```sh\nkubectl create ns mcp-server\n```\n\nDeploy the MCP gateway server.\n\nNote: We have created a image for the MCP Gateway that can be used to deploy the MCP server(s) in your Kubernetes cluster.\n\n```sh\nkubectl apply -f mcp-gateway/\n```\nFor more information about the MCP Gateway piece, see the [MCP Gateway repository](https://github.com/david-martin/mcp-gateway-poc) .\n\n\nEnsure the mcp gateway (Server) is up and running:\n    ```sh\n    kubectl get pods -n mcp-server\n    ```\n\n## Deploying Kuadrant policies \n\nClone the Repository\n```sh\ngit clone https://github.com/your-org/Kuadrant-MCP-Walkthrough.git\ncd Kuadrant-MCP-Walkthrough\n```\n\n Create the gateway namespace:\n\n```sh\nkubectl create ns mcp-gateway\n```\n\nCreate the secret credentials in the same namespace as the Gateway - these will be used to configure DNS:\n\n```sh\nkubectl -n mcp-gateway create secret generic aws-credentials \\\n--type=kuadrant.io/aws \\\n--from-literal=AWS_ACCESS_KEY_ID=$KUADRANT_AWS_ACCESS_KEY_ID \\\n--from-literal=AWS_SECRET_ACCESS_KEY=$KUADRANT_AWS_SECRET_ACCESS_KEY\n```\n\nCreate the secret credentials in the cert-manager namespace:\n\n```sh\nkubectl -n cert-manager create secret generic aws-credentials \\\n--type=kuadrant.io/aws \\\n--from-literal=AWS_ACCESS_KEY_ID=$KUADRANT_AWS_ACCESS_KEY_ID \\\n--from-literal=AWS_SECRET_ACCESS_KEY=$KUADRANT_AWS_SECRET_ACCESS_KEY\n```   \n\nApply the policies\n```sh\nkubectl apply -f kuadrant/\n```\nThis will deploy :\n* Gateway\n* AuthN Auth policy\n* AuthZ Auth policy for specific MCP tools\n* RateLimit policy\n* RateLimit policy for specific MCP tool\n* Dns policy\n* HTTPRoute\n  \n\n## Setting Up MCP Inspector to test your policies\n\nNote: Adding custom hearers to MCP Inspector is not supported in the current version. Theres is a PR open with this feature implemented, which works perfectly so that can be used instead https://github.com/modelcontextprotocol/inspector/pull/549 \n\n\nClone the MCP Inspector Repository\n```bash\ngit clone https://github.com/popomore/inspector.git\ncd mcp-inspector\n```\n\nDeploy MCP Inspector\n```bash\nnpm run build\nnpm start\n```\n\nAccess MCP Inspector\nWhen the MCP Inspector is running, you can access it via the following URL. The auth token will be outputted in the terminal when you run the inspector. Replace `\u003cyour-auth-token\u003e` with the actual token provided by the MCP Inspector.\n```\nhttp://localhost:6274/?MCP_PROXY_AUTH_TOKEN=\u003cyour-auth-token\u003e\n```\nFrom there you can setup the MCP Inspector to use authorisation and test out the tools the MCP server provides.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuadrant%2Fkuadrant-mcp-walkthrough","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkuadrant%2Fkuadrant-mcp-walkthrough","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuadrant%2Fkuadrant-mcp-walkthrough/lists"}