zfinix/mcp_server_dart

一个开发者友好型MCP（模型上下文协议）框架，适用于Dart，支持注释和代码生成。构建MCP服务器和注释方法一样简单，比如用@MCPTool、@MCPResource或@MCPPrompt——类似于json_serializable或freezed的工作原理。

✨ 特色

• ** 🏷️ 基于注释的**：声明MCP工具、资源和提示，并附带简单注释
• ** 🔧 代码生成**：使用build_runner的自动样板生成，基于扩展注册
• ** ✨ 无需@override]：无需继承模板的干净方法声明
• ** 📡 多重传输**：支持stdio、HTTP和带有服务器发送事件（SSE）的可流式HTTP。
• ** 🔍 类型安全**：全Dart类型安全，具备自动参数提取功能
• ** 📚 JSON 模式**：从方法签名自动生成输入模式
• ** 🧪 完全测试**：包含JSON-RPC命令验证的综合测试套件
• ** ⚡ 生产准备**：当前MCP 2025-11-25对齐协议实现，采用Relic HTTP服务器
• ** 🧠 现代化功能**：内置支持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! 👋';
  }