kubesearch-mcp
by perfectra1n
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Alternative for MCP_HTTP_PORT. | 3000 |
| GITHUB_TOKEN | No | Lifts the GitHub API rate limit (60→5000/hr) used to resolve the latest release. Recommended. | |
| MCP_HTTP_HOST | No | HTTP bind host (HTTP transport). | 0.0.0.0 |
| MCP_HTTP_PORT | No | HTTP listen port (HTTP transport). Also accepts PORT. | 3000 |
| MCP_TRANSPORT | No | Transport mode: stdio or http. Defaults to 'stdio' outside Docker, 'http' inside Docker. | stdio |
| MCP_AUTH_TOKEN | No | If set, every HTTP request must send Authorization: Bearer <token>. | |
| KUBESEARCH_CACHE_DIR | No | Where the SQLite databases are cached. In Docker default is /data. | ~/.cache/kubesearch-mcp |
| KUBESEARCH_CLONE_DIR | No | Where ephemeral clones live. | <cacheDir>/clones |
| KUBESEARCH_CLONE_MAX_MB | No | Reject/clean a clone whose tree exceeds this size. | 200 |
| KUBESEARCH_ENABLE_CLONE | No | Enable the repo_* clone/review tools. Set 'false' to hide them entirely. | true |
| KUBESEARCH_REFRESH_HOURS | No | How often to check for a newer daily release. 0 disables refresh. | 24 |
| KUBESEARCH_UPSTREAM_REPO | No | Source repo for the databases (override only for forks/testing). | whazor/k8s-at-home-search |
| KUBESEARCH_CLONE_MAX_REPOS | No | Max concurrent cached clones (LRU-evicted). | 5 |
| KUBESEARCH_CLONE_TTL_MINUTES | No | Auto-delete a clone after this much inactivity. | 30 |
| KUBESEARCH_CLONE_ALLOWED_HOSTS | No | Comma-separated host allowlist. Empty = any public host. | |
| KUBESEARCH_CLONE_ALLOW_PRIVATE | No | Permit cloning from private/loopback/link-local/metadata addresses (SSRF guard off). | false |
| KUBESEARCH_CLONE_TIMEOUT_SECONDS | No | Hard timeout for the git clone subprocess. | 120 |
| KUBESEARCH_CLONE_REFRESH_ON_CLONE | No | On a repeat clone of the same repo, git fetch + reset to latest commit. | true |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/perfectra1n/kubesearch-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server