패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소rohit-chouhan/mcp_schema_generator

mcp_schema_generator

주석 기반 모델 컨텍스트 프로토콜(MCP) 서버 코드 생성기. 자동으로 스키마를 생성하여 반복 코드를 제거합니다

mcp_schema_generator 프로젝트 이미지
스타
0
포크
0
최근 푸시(UTC)
2026. 6. 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 ↗