mcp_dart

mcp_dartは、Dartプログラミング言語用のModel Context Protocol(MCP)ライブラリです。このライブラリは、LLMアプリケーションと外部データソースやツールとのシームレスな統合を可能にします。DartでのMCPサーバーとクライアントの実装を簡単かつ直感的に行えるように設計されており、他の言語の公式SDKと一貫性のある開発体験を提供します。

GitHubスター

56

ユーザー評価

未評価

フォーク

12

イシュー

4

閲覧数

0

お気に入り

0

README
MCP(Model Context Protocol) for Dart

Pub Version likes

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.

{
  "mcpServers": {
    "calculator_jit": {
      "command": "path/to/dart",
      "args": [
        "/path/to/server_stdio.dart"
      ]
    },
    "calculator_aot": {
      "command": "path/to/compiled/server_stdio",
    },
  }
}
More examples

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

Credits

This library is inspired by the following projects:

作者情報
Jhin Lee
UnityMontreal

48

フォロワー

32

リポジトリ

4

Gist

92

貢献数

トップ貢献者

スレッド