Dart LSP MCP

A Model Context Protocol (MCP) server that provides Dart language analysis capabilities to Claude Code. This tool uses the Dart language server to provide real-time diagnostics, code navigation, and symbol search for Dart projects.

Features

• Real-time Diagnostics: Get errors, warnings, and hints from the Dart analyzer
• Go to Definition: Navigate to symbol definitions
• Find References: Find all usages of a symbol
• Hover Information: Get type information and documentation
• Document Symbols: List all symbols in a file
• Workspace Symbol Search: Search for symbols across the project

Prerequisites

• Python 3.10+
• uv (Python package manager)
• Dart SDK (must be in PATH)

Installation

1. Clone this repository
2. Install dependencies:

uv sync

Usage

As MCP Server (for Claude Code)

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "dart-lsp": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "D:\\GIT\\BenjaminKobjolke\\dart-lsp-mcp", "run", "python", "-m", "dart_lsp_watcher.mcp_server"]
    }
  }
}

As CLI Tool

Watch a Dart project for diagnostics:

# Watch mode (continuous)
start.bat path/to/dart/project

# Check a single file
check.bat lib/main.dart path/to/dart/project

# Get server capabilities
capabilities.bat path/to/dart/project

Available CLI Commands

MCP Tools

When used as an MCP server, the following tools are available:

Configuration

Create a dart_lsp.json file in your project root to configure ignore patterns:

{
  "ignore": [
    "build/**",
    ".dart_tool/**",
    "**/*.g.dart"
  ]
}

Development

Run tests:

tools\tests.bat

License

MIT