zfinix/mcp_server_dart

A ** 개발자 친화적 인 MCP (모델 Context Protocol) 프레임 워크 ** ** 및 ** 코드 생성 **. MCP 서버를 쉽게 @MCPTool, @MCPResource, 또는 @MCPPrompt]]와 같은 json_serializable 또는 freezed]] 작동 방식로 구축하십시오.

✨ 특징

-** An️ Annotation-based**: MCP 도구, 리소스 및 간단한 주석으로 프롬프트

• ** 過去 Code 생성**: build_runner]를 사용하여 자동 보일러판 생성
• ✨ @override필수: 상속 보일러판없이 깨끗한 방법 선언
• ** Multiple 배수 수송 : stdio, HTTP 및 Server-Sent Events (SSE)와 Streamable HTTP 지원 - Array Type-safe**: 자동 파라미터 추출을 통한 Full Dart type 안전
• ** JSON 신종**: 메소드 서명에서 자동 입력 스키마 생성
• ** Fully 완전 테스트**: JSON-RPC 명령어 유효성 검사
• ** : 현재 MCP 2025-11-25-aligned 프로토콜 구현 - Modern 현대 기능: MCP 로깅, 완료, 작업 증강 도구 호출 및 풍부한 메타 데이터 초기 지원

A developer-friendly MCP (Model Context Protocol) framework for Dart with annotations and code generation. Build MCP servers as easily as annotating methods with @MCPTool, @MCPResource, or @MCPPrompt - similar to how json_serializable or freezed works.

✨ Features

• 🏷️ Annotation-based: Declare MCP tools, resources, and prompts with simple annotations
• 🔧 Code generation: Automatic boilerplate generation using build_runner with extension-based registration
• ✨ No @override required: Clean method declarations without inheritance boilerplate
• 📡 Multiple transports: Support for stdio, HTTP, and Streamable HTTP with Server-Sent Events (SSE)
• 🔍 Type-safe: Full Dart type safety with automatic parameter extraction
• 📚 JSON Schema: Automatic input schema generation from method signatures
• 🧪 Fully tested: Comprehensive test suite with JSON-RPC command validation
• ⚡ Production ready: Current MCP 2025-11-25-aligned protocol implementation with Relic HTTP server
• 🧠 Modern capabilities: Built-in support for MCP logging, completions, task-augmented tool calls, and richer initialize metadata
• 🌐 Modern HTTP: Built on Relic framework with middleware support, CORS, logging, and health checks
• 🔧 Monitoring: Built-in health check endpoints and connection monitoring
• 📊 SSE Support: Server-Sent Events for real-time streaming on the modern MCP streamable HTTP transport

🚀 Quick Start

1. Add Dependencies

dependencies:
  mcp_server_dart: ^1.1.2
  relic: ^0.5.0  # Modern HTTP framework
  logging: ^1.3.0  # For server logging

dev_dependencies:
  build_runner: ^2.4.13

2. Create Your MCP Server

import 'package:mcp_server_dart/mcp_server_dart.dart';

part 'my_server.mcp.dart'; // Generated file

class MyMCPServer extends MCPServer {
  MyMCPServer() : super(name: 'my-server', version: '1.0.0') {
    // Register all generated handlers using the extension
    registerGeneratedHandlers();
  }

  @MCPTool('greet', description: 'Greet someone by name')
  Future greet(String name) async {
    return 'Hello, $name! 👋';
  }