Dealership AI MCP Server

MCP server that gives AI agents superpowers when working across the Dealership AI / AllyAI codebase. Instead of spending 20+ tool calls exploring a repo, agents get instant architecture understanding, pattern-aware code generation, cross-repo search, and one-call validation.

Why This Exists

Giving an agent direct repo access is slow — they spend most of their time exploring, reading files to understand patterns, and manually validating. This MCP server eliminates that overhead:

Setup

pip install -e .

Adding to Claude Code

{
  "mcpServers": {
    "dealership-ai": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/mcp-server"
    }
  }
}

Adding to Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "dealership-ai": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/mcp-server"
    }
  }
}

Tool Categories

Context Tools — Instant Codebase Understanding

• get_codebase_summary(repo) — Full architecture: framework, endpoints, models, deps, env vars, biggest files

• extract_patterns(repo) — Coding conventions: import style, endpoint patterns, error handling, model patterns, naming

• get_function_context(repo, func) — Complete context: definition, callers, callees, tests, imports

• get_api_surface(repo) — All endpoints with request/response types and router registration

• get_dependency_graph(repo) — Internal module import graph (foundational vs leaf modules)

Scaffold Tools — Pattern-Aware Code Generation

• scaffold_fastapi_endpoint(...) — Generate endpoint matching the repo's exact patterns

• scaffold_react_component(...) — Generate component with proper imports, styling, hooks

• scaffold_pydantic_model(...) — Generate model matching conventions

• scaffold_test(repo, file) — Generate test file for any source file

• scaffold_from_example(repo, template_file, new_name, modifications) — Clone + modify any file

• create_new_repo(name, template, description) — Create new GitHub repo (fastapi/react-vite/python-service)

Cross-Repo Tools — Multi-Repo Operations

• search_all_repos(pattern) — Search all 7 repos simultaneously

• get_service_map() — Discover how services connect: shared Firestore, env vars, external APIs

• find_shared_models() — Find data models that appear across repos (API contracts)

• get_deployment_overview() — Docker, ports, Cloud Run config for all repos

• batch_git_status() — Git status of all repos in one call

• batch_git_pull() — Pull all repos at once

• batch_create_branch(name) — Create same branch across all repos

Validation Tools — Quality Before Committing

• validate_repo(repo) — Full suite: syntax + lint + type check + tests

• validate_changes(repo) — Validate only uncommitted files (fast)

• check_syntax(repo, file) — Quick syntax check on one file

• check_imports(repo, file) — Verify all imports resolve

• run_tests(repo) — Run test suite

Core Tools — File, Git, Repo Management

• File ops: read_file, write_file, edit_file, delete_file, list_files, search_code, get_file_tree

• Git ops: git_status, git_diff, git_log, git_branch, git_checkout, git_add, git_commit, git_push, git_pull, git_stash, create_pull_request, run_command

• Repo ops: list_repos, clone_repo, clone_all_repos, get_repo_info, pull_repo

Resources (Auto-Loaded Context)

• repo://overview — Complete system architecture and how services connect

• repo://conventions — Coding patterns across all repos

• repo://quick-start — Step-by-step guide for agents

Prompts (Task Templates)

• implement_feature(repo, description) — Guided feature implementation

• fix_bug(repo, description) — Guided bug fixing

• add_endpoint(repo, description) — Guided endpoint addition

• cross_repo_change(description) — Guided multi-repo changes

Configured Repos