Dart LSP MCP

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

| Command | Description | |---------|-------------| | start.bat <folder> | Watch folder for Dart diagnostics | | check.bat <file> [folder] | Check a single file | | definition.bat <file> <line> <col> [folder] | Go to definition | | references.bat <file> <line> <col> [folder] | Find references | | hover.bat <file> <line> <col> [folder] | Get hover info | | symbols.bat <file> [folder] | List document symbols | | search.bat <query> [folder] | Search workspace symbols | | capabilities.bat [folder] | Show LSP capabilities |

MCP Tools

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

| Tool | Description | |------|-------------| | get_diagnostics | Get Dart diagnostics for a project or specific file | | find_references | Find all references to a symbol at a position | | go_to_definition | Navigate to symbol definition | | get_hover | Get documentation and type info for a symbol | | get_document_symbols | List all symbols in a file | | search_symbols | Search for symbols across the workspace | | get_capabilities | Get LSP server capabilities | | reindex | Re-scan workspace to detect new/removed Dart files |

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