tilt-mcp

What it is and what it does

Tilt MCP Server is a bridge that lets Large Language Models and AI assistants interact with your Tilt development environment. It implements the Model Context Protocol, exposing two main capabilities: listing all active Tilt resources with their current status, and fetching recent logs from any resource. The server is built on fastmcp and runs as a standalone process that MCP-compatible clients (like Claude Desktop or mcp-cli) can connect to.

The package is designed for developers using Tilt to manage Kubernetes-based development workflows. It enables AI-powered debugging, automated monitoring, and natural-language queries about your services—for example, asking an AI assistant to show failing services or retrieve logs from a specific resource. It requires Python 3.8 or higher and an existing Tilt installation; the server communicates with Tilt via its API to fetch resource and log data.

Use it for:

• Ask an AI assistant to list all currently running Tilt resources and their health status without manually checking the Tilt UI
• Retrieve the last N lines of logs from a specific service for debugging, triggered through natural language to an LLM
• Identify and debug failing or unhealthy services by querying Tilt state through an AI assistant
• Automate monitoring workflows where an LLM periodically checks resource status and alerts on anomalies
• Integrate Tilt resource visibility into an AI-powered development assistant or chatbot

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Tilt MCP Server exposes Tilt development environment resources and logs to LLM applications through the Model Context Protocol, enabling AI assistants to query resource status and retrieve logs programmatically.

Yes, if you use Tilt for Kubernetes development and want to integrate it with LLM applications. Install friction is minimal and the MIT license is permissive. However, the package is in Alpha with no updates since initial release, so treat it as experimental; verify that fastmcp is maintained and that the API meets your stability requirements before relying on it in production workflows.

Install

tilt-mcp on PyPI

pip install tilt-mcp

uv add tilt-mcp

poetry add tilt-mcp

Installing tilt-mcp

Before you install

Low install friction with a single pure-Python dependency (fastmcp). The package is in Alpha status and has not seen updates since its initial release 395 days ago, though the repository remains active and unarchived.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions, making it suitable for both commercial and private projects.

Quickstart

pip install tilt-mcp

# Configure in Claude Desktop config file (e.g., ~/.config/claude/claude_desktop_config.json):
# {
#   "mcpServers": {
#     "tilt": {
#       "command": "tilt-mcp"
#     }
#   }
# }

# Or run directly:
python -m tilt_mcp.server

Requires Tilt to be installed, configured, and running; an MCP-compatible client (e.g., Claude Desktop) to connect to the server; Python 3.8 or higher.

Verify before relying

• Whether fastmcp is actively maintained and what its own dependency footprint is
• Stability and API compatibility guarantees for an Alpha-stage package
• Performance characteristics when querying large numbers of resources or logs

Package facts

Evidence: tilt_mcp-0.1.3-py3-none-any.whl

Keywords: mcp, tilt, kubernetes, development, model-context-protocol

Tags

More Python Modules packages

Further reading