devserver-mcp GEMINI.md

Project Instructions

Project: Devserver MCP

This project is a Model Context Protocol (MCP) server that manages development servers (Django, Vue, Celery, etc.) for LLM-assisted development workflows. Provides programmatic control over multiple development servers through a unified interface with a beautiful TUI.

Quick Reference

• Dependency and environment management: uv
  • uv add [package] -- add dependency
  • uv add --dev [package] -- add dev dependency
  • uv run [command in .venv context] -- run a command in the project environment
  • pyproject.toml -- Python project configuration
• Tests:
  • Run with: use your run_tests tool or uv run pytest
  • In tests/
• Use Ruff for linting and formatting:
  • uv run ruff check --fix path/to/file.py -- fix all fixable linting errors
  • uv run ruff format path/to/file.py -- format
• Test the server implementation using the test app (see details below): uv run devservers

Coding Guidelines

• Python 3.13+, type hints, PEP 8
• Handle errors explicitly
• Never add any comments or doctsrings unless asked to
• Always follow security best practices. Never introduce code that exposes or logs secrets and keys
• Always lint and format all the code you write using Ruff

Testing Guidelines

• Adhere to the general testing guidelines in docs/writing_tests.md
• Write meaningful tests, not coverage fillers
• Always use pytest functions, never use classes
• When creating or fixing tests, always run the full test suite to make sure all tests pass

Test App Structure

testapp/
├── front/          # simple Vite app
└── backend.py      # simple FastAPI app
devservers.yml       # Test configuration

Documentation

• See docs/design.md for technical design specs
• See latest FastMCP documentation at: https://gofastmcp.com/llms-full.txt
• Check existing code patterns before implementing new features
• Textual documentation: https://textual.textualize.io/guide/

Change Logging