What is Mcp Dart

mcp_dart is a Dart implementation of the Model Context Protocol (MCP) SDK, designed to facilitate seamless integration between LLM applications and external data sources and tools.

Use cases

Use cases for mcp_dart include building interactive applications that perform calculations, integrating external APIs for data retrieval, and developing tools that enhance the functionality of LLM applications.

How to use

To use mcp_dart, ensure you have Dart SDK version 3.7.2 or higher installed. You can start an MCP server by importing the library and initializing an instance of McpServer with the required options and capabilities.

Key features

Key features of mcp_dart include Stdio support for both server and client, Server-Sent Events (SSE) support for the server, and the ability to define tools, resources, and prompts within the MCP framework.

Where to use

mcp_dart can be used in various fields that require integration of language models with external data sources, such as AI applications, chatbots, and data processing tools.

MCP(Model Context Protocol) for Dart

Model Context Protocol (MCP) is an open protocol designed to enable seamless integration between LLM applications and external data sources and tools.

This library aims to provide a simple and intuitive way to implement MCP servers and clients in Dart, while adhering to the MCP protocol spec. The goal is to make this SDK as similar as possible to the official SDKs available in other languages, ensuring a consistent developer experience across platforms.

Requirements

• Dart SDK version ^3.0.0 or higher

Ensure you have the correct Dart SDK version installed. See https://dart.dev/get-dart for installation instructions.

Features

• Stdio support (Server and Client)
• StreamableHTTP support (Server and Client)
• SSE support (Server only) - Deprecated
• Stream Transport using dart streams (Server and Client in shared process)
• Tools
• Resources
• Prompts
• Sampling
• Roots

Model Context Protocol Version

The current version of the protocol is 2025-03-26. This library is designed to be compatible with this version, and any future updates will be made to ensure continued compatibility.

It’s also backward compatible with the previous version 2024-11-05 and 2024-10-07.

Getting started

Below code is the simplest way to start the MCP server.

import 'package:mcp_dart/mcp_dart.dart';

void main() async {
  McpServer server = McpServer(
    Implementation(name: "mcp-example-server", version: "1.0.0"),
    options: ServerOptions(
      capabilities: ServerCapabilities(
        resources: ServerCapabilitiesResources(),
        tools: ServerCapabilitiesTools(),
      ),
    ),
  );

  server.tool(
    "calculate",
    description: 'Perform basic arithmetic operations',
    inputSchemaProperties: {
      'operation': {
        'type': 'string',
        'enum': ['add', 'subtract', 'multiply', 'divide'],
      },
      'a': {'type': 'number'},
      'b': {'type': 'number'},
    },
    callback: ({args, extra}) async {
      final operation = args!['operation'];
      final a = args['a'];
      final b = args['b'];
      return CallToolResult(
        content: [
          TextContent(
            text: switch (operation) {
              'add' => 'Result: ${a + b}',
              'subtract' => 'Result: ${a - b}',
              'multiply' => 'Result: ${a * b}',
              'divide' => 'Result: ${a / b}',
              _ => throw Exception('Invalid operation'),
            },
          ),
        ],
      );
    },
  );

  server.connect(StdioServerTransport());
}

Usage

Once you compile your MCP server, you can compile the client using the below code.

dart compile exe example/server_stdio.dart -o ./server_stdio

Or just run it with JIT.

dart run example/server_stdio.dart

To configure it with the client (ex, Claude Desktop), you can use the below code.

More examples

https://github.com/leehack/mcp_dart/tree/main/example

Credits

This library is inspired by the following projects:

• https://github.com/crbrotea/dart_mcp
• https://github.com/nmfisher/simple_dart_mcp_server