パッケージ、リポジトリ、アプリカテゴリを検索

GitHub リポジトリrohit-chouhan/mcp_schema_generator

mcp_schema_generator

アノテーション駆動型モデルコンテキストプロトコル(MCP)サーバーコードジェネレーター。自動的にスキーマを生成することでボイラープレートを排除します

mcp_schema_generator のプロジェクト画像
スター
0
フォーク
0
最終プッシュ(UTC)
2026/06/19
プロジェクト状態
公開中

元の README

以下は英語原文のスナップショットです。最新版は GitHub をご覧ください。

mcp_schema_generator

Annotation-driven MCP server generation for Dart & Flutter.

Eliminates Model Context Protocol (MCP) boilerplate by generating tool registration, JSON schemas, parameter parsing, and error handling from simple Dart annotations.

Features

  • Zero Boilerplate: Automatically map Dart methods to MCP Tools.
  • JSON Schema Generation: Converts Dart types (String, int, List, Enum, nullables) into strictly typed JSON schemas.
  • Built-in Validation: Specify boundaries with @McpParam(minimum: 1).
  • Type Safety: The generated code provides strongly typed ToolDefinition metadata maps.

Installation

Add the dependencies to your pubspec.yaml:

dependencies:
  mcp_schema_annotations: ^1.0.0-beta.3
  mcp_schema_runtime: ^1.0.0-beta.3

dev_dependencies:
  mcp_schema_generator: ^1.0.0-beta.3
  build_runner: ^2.15.0

Quick Start

  1. Annotate your server class and methods.
import 'package:mcp_schema_annotations/mcp_schema_annotations.dart';
import 'package:mcp_schema_runtime/mcp_schema_runtime.dart';

part 'server.g.dart'; // The generated file

@McpServer(name: 'analytics_server')
class AnalyticsServer {

  @McpTool(description: 'Get user details')
  Future<User> getUser(
    @McpParam(description: 'User ID', minimum: 1) int id,
  ) async {
    return User(id);
  }
}
  1. Run the generator
dart run build_runner build
  1. Access the generated metadata!
final server = AnalyticsServer();
print(server.mcpTools); // List of generated ToolDefinitions!
print(server.mcpToolMap); // Map of tool names to ToolDefinitions!

Annotations

  • @McpServer(name: 'server_name'): Marks a class as an MCP server.
  • @McpTool(name: 'toolName', description: '...'): Marks a method as an MCP Tool.
  • @McpParam(description: '...', minimum: 0, maximum: 10, pattern: r'^[A-Z]$'): Provides additional JSON Schema metadata constraints for parameters.

Generated Output

The generator produces a Dart extension on your server class:

extension AnalyticsServerMcpExtension on AnalyticsServer {
  List<ToolDefinition> get mcpTools => [
    ToolDefinition(
      name: 'getUser',
      description: 'Get user details',
      inputSchema: {
        'type': 'object',
        'properties': {
          'id': {
             'description': 'User ID',
             'minimum': 1,
             'type': 'integer',
          }
        },
        'required': ['id']
      }
    )
  ];

  Map<String, ToolDefinition> get mcpToolMap => { ... };
}

Supported Types

  • String -> string
  • int -> integer
  • double / num -> number
  • bool -> boolean
  • List<T> -> array
  • Enum -> string (with enum list)
  • Nullable types (e.g. String?) are omitted from the required array.

Limitations

  • Custom DTO generation: Custom classes in parameters currently fallback to {"type": "object"}. Deep nested schema generation for custom DTOs is not yet supported.
  • Unsupported Types: Core classes like Stream, Socket, File, and Future cannot be used as tool parameters.
Rohit Chouhan GitHub avatar
GitHub 作者

Rohit Chouhan ↗

Technology Analyst at adidas

adidasJaipur - Gurugram公式サイト ↗
言語Dart

カテゴリー

プロジェクトに合うリポジトリを選ぶには?

用途で絞り込み、開発状況を比較し、採用前に元のリポジトリで要件を確認しましょう。

  1. 名前・作者・説明で検索し、技術トピックで絞り込みます。
  2. スター、フォーク、最近のプッシュを比較します。スターは関心の目安であり、品質の保証ではありません。
  3. 利用前に GitHub で README、ライセンス、Issues を確認します。

情報源と管理

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗