tilt-mcp

# Tilt MCP Server A Model Context Protocol (MCP) server that integrates with [Tilt](https://tilt.dev/) to provide programmatic access to Tilt resources and logs through LLM applications. ## Overview The Tilt MCP server allows Large Language Models (LLMs) and AI assistants to interact with your Tilt development environment. It provides tools to: - List all enabled Tilt resources - Fetch logs from specific resources - Monitor resource status and health This enables AI-powered development workflows, debugging assistance, and automated monitoring of your Tilt-managed services. ## Features - 🔍 **Resource Discovery**: List all active Tilt resources with their current status - 📜 **Log Retrieval**: Fetch recent logs from any Tilt resource - 🛡️ **Type Safety**: Built with Python type hints for better IDE support - 🚀 **Async Support**: Fully asynchronous implementation using FastMCP - 📊 **Structured Output**: Returns well-formatted JSON responses ## Prerequisites - Python 3.8 or higher - [Tilt](https://docs.tilt.dev/install.html) installed and configured - An MCP-compatible client (e.g., Claude Desktop, mcp-cli) ## Installation ### From PyPI (recommended) ```bash pip install tilt-mcp ``` ### From Source ```bash git clone https://github.com/aryan-agrawal-glean/tilt-mcp.git cd tilt-mcp pip install -e . ``` ## Configuration ### For Claude Desktop Add the following to your Claude Desktop configuration file: **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` **Linux**: `~/.config/claude/claude_desktop_config.json` ```json { "mcpServers": { "tilt": { "command": "tilt-mcp" } } } ``` ### For Development/Testing You can run the server directly: ```bash python -m tilt_mcp.server ``` Or use it with the MCP CLI: ```bash mcp run python -m tilt_mcp.server ``` ## Usage Once configured, the Tilt MCP server provides the following tools: ### `get_all_resou…