Dart

Dart MCP Server exposes a set of MCP endpoints that let you run common Dart and Flutter tooling from an MCP client. It bridges AI-assisted workflows with Dart development by letting you analyze, format, build, test, and manage Dart projects through a consistent MCP interface.

How to use

You connect to the Dart MCP Server from your MCP client (such as Windsurf or Codeium) and invoke the included Dart SDK commands as MCP endpoints. The server automatically resolves paths, detects Dart/Flutter projects, and works across macOS, Linux, and Windows. Your client sends a request to perform actions like analysis, formatting, creation, documentation, or testing, and the server returns the results and diagnostics.

How to install

Prerequisites you need before starting: Node.js version 18.x or higher and Dart SDK version 3.0 or higher installed and accessible in your PATH.

Install via Smithery

npx -y @smithery/cli install @egyleader/dart-mcp --client claude

Using npx (recommended)

Run the MCP server directly without installation using npx.

npx @egyleader/dart-mcp-server

Global installation

Install the server globally for easy access from any directory.

npm install -g @egyleader/dart-mcp-server

dart-mcp-server

From source

If you prefer building from source, follow these steps to clone, install, build, and run locally.

# Clone the repository
git clone https://github.com/egyleader/dart-mcp-server.git
cd dart-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
node dist/index.js

Configuration with MCP clients

Configure your MCP client to load the server. The following example shows how to reference the Dart MCP Server with an MCP config, enabling you to issue requests to the server from your client.

{
  "mcpServers": {
    "dart": {
      "command": "npx",
      "args": [
        "-y",
        "@egyleader/dart-mcp-server"
      ]
    }
  }
}

Environment variables

Enable verbose logging for debugging by setting DART_MCP_VERBOSE to any value.

Security notes

Run the server with the minimum required permissions and limit access to trusted clients. Review your environment for sensitive data and ensure you manage credentials securely.

Examples and quick-start

After you have the server running, you can perform common actions such as analyzing code, formatting, creating projects, or running tests through your MCP client. The server exposes commands like dart-analyze, dart-format, dart-create, dart-test, and more through the MCP interface.

Troubleshooting

If a command fails, verify Node.js and Dart SDK are in your PATH, confirm the MCP client is configured correctly, and check that the server process has sufficient permissions. Enable verbose logging with DART_MCP_VERBOSE to gather more details.

Notes

The MCP server integrates with any MCP client and is designed to auto-detect Dart/Flutter projects, resolve relative paths, and operate cross-platform. Use the provided MCP config example to bootstrap your setup.

License

MIT License. See the LICENSE file for details.

Available tools

dart-analyze

Analyze Dart code in a directory or file to surface errors, warnings, and lints.

dart-compile

Compile Dart code to formats such as exe, aot-snapshot, jit-snapshot, kernel, or js.

dart-create

Create a new Dart project from templates like console, package, server-shelf, or web.

dart-doc

Generate API documentation for a Dart project.

dart-fix

Apply automated fixes to Dart source code.

dart-format

Format Dart source code to conform to style guidelines.

dart-info

Show diagnostic information about the installed Dart tooling.

dart-package

Manage Dart/Flutter packages (pub commands) like get, upgrade, add, remove, etc.

dart-run

Run Dart programs with support for passing arguments.

dart-test

Run tests with options for filtering and reporting.