पैकेज, रिपॉज़िटरी और ऐप श्रेणियाँ खोजें

GitHub रिपॉज़िटरीrohit-chouhan/mcp_schema_generator

mcp_schema_generator

एनोटेशन-आधारित मॉडल कंटेक्स्ट प्रोटोकॉल (MCP) सर्वर कोड जनरेटर। बॉयलरप्लेट को स्वचालित रूप से स्कीमा बनाकर हटा देता है

mcp_schema_generator प्रोजेक्ट कवर
स्टार
0
फ़ोर्क
0
अंतिम पुश (UTC)
19 जून 2026
प्रोजेक्ट स्थिति
सक्रिय

मूल 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

भाषाएँDart

श्रेणियाँ

अपने प्रोजेक्ट के लिए रिपॉज़िटरी कैसे चुनें?

उपयोग के अनुसार छाँटें, गतिविधि की तुलना करें और अपनाने से पहले मूल प्रोजेक्ट की आवश्यकताएँ जाँचें।

  1. नाम, लेखक या विवरण से खोजें और तकनीकी विषय से परिणाम सीमित करें।
  2. स्टार, फ़ोर्क और हाल के पुश की तुलना करें। स्टार रुचि दर्शाते हैं, गुणवत्ता की गारंटी नहीं।
  3. उपयोग से पहले GitHub पर README, लाइसेंस और Issues जाँचें।

स्रोत और रखरखाव

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

GitHub Docs — About repositories ↗