mcp_schema_generator
주석 기반 모델 컨텍스트 프로토콜(MCP) 서버 코드 생성기. 자동으로 스키마를 생성하여 반복 코드를 제거합니다
- 스타
- 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
ToolDefinitionmetadata 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
- 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);
}
}
- Run the generator
dart run build_runner build
- 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->stringint->integerdouble/num->numberbool->booleanList<T>->arrayEnum->string(withenumlist)- Nullable types (e.g.
String?) are omitted from therequiredarray.
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, andFuturecannot be used as tool parameters.
언어Dart
분류
프로젝트에 맞는 저장소를 선택하려면?
사용 목적에 따라 검색하고 개발 활동을 비교한 뒤 원본 저장소에서 요구 사항을 확인하세요.
- 이름, 작성자 또는 설명으로 검색하고 기술 주제로 범위를 좁힙니다.
- 스타, 포크, 최근 푸시를 함께 비교하세요. 스타는 관심의 지표이며 품질을 보장하지 않습니다.
- 사용하기 전에 GitHub에서 README, 라이선스, Issues를 확인하세요.
출처 및 관리
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗