mcp_dart 1.1.1

mcp_dart: ^1.1.1 copied to clipboard

• Structured Content Support: Added explicit structuredContent field to CallToolResult with automatic backward compatibility support.
  • CallToolResult.fromStructuredContent now automatically populates both structuredContent (for modern clients) and content (as JSON string for legacy clients).
  • Updated validation logic to correctly validate structuredContent payload against tool schema.

Breaking Changes #

• Protocol Version Update: Updated default protocol version to 2025-11-25.
• Strict Capabilities Typing: ServerCapabilities and ClientCapabilities fields (tasks, sampling, elicitation, etc.) are now strictly typed objects instead of Map<String, dynamic> or bool.
  • Updated ServerCapabilities to use ServerCapabilitiesTasks, ServerCapabilitiesTools, etc.
  • Updated ClientCapabilities to use ClientCapabilitiesTasks, ClientCapabilitiesElicitation, ClientCapabilitiesSampling, etc.
  • Migration: Update capability declarations to use the new typed classes (e.g., ServerCapabilities(tasks: ServerCapabilitiesTasks(listChanged: true))).
• File Removal: lib/src/server/mcp.dart has been removed. Use lib/src/server/mcp_server.dart (exported via lib/src/server/module.dart) instead.
• Transport Interface Change: Transport.send now accepts an optional named parameter relatedRequestId. Custom transports must update their method signature.
• Client Validation: Client.callTool now strictly validates tool outputs against their defined JSON schema (if present). Mismatches will throw an McpError(ErrorCode.invalidParams).
• API Refactoring:
  • McpServer.tool, resource, and prompt are deprecated. Use registerTool, registerResource, and registerPrompt instead.
  • McpServer.registerTool uses a new callback signature: FutureOr<CallToolResult> Function(Map<String, dynamic> args, RequestHandlerExtra extra).
  • The deprecated McpServer.tool retains the old named-parameter signature for backward compatibility.
• Tool Schema Definitions: ToolInputSchema (aka JsonObject) now requires properties to be defined using JsonSchema objects (e.g., JsonSchema.string()) instead of raw Maps.
• Tool Listing Types: ListToolsRequestParams has been replaced by ListToolsRequest (update any code passing params: to Client.listTools or constructing JsonRpcListToolsRequest).
• Tool Result Structured Content: CallToolResult no longer uses a dedicated structuredContent field in its API; structured results are represented as additional top-level fields (CallToolResult.extra). CallToolResult.fromStructuredContent now takes a single Map<String, dynamic> argument.
• RequestHandlerExtra Signature Changes: RequestHandlerExtra.sendNotification and RequestHandlerExtra.sendRequest have updated signatures (added task-related metadata/options). Update any server callbacks that call these helpers directly.

Features #

• Task Management System:
  • Implemented comprehensive Task support in lib/src/server/tasks/.
  • Introduced TaskStore abstract interface with InMemoryTaskStore as the default implementation.
  • Added strictly typed TaskResultHandler and TaskSession.
  • Introduced TaskMessageQueue for handling task messages.
• McpServer Enhancements:
  • Added McpServer high-level support for tasks via tasks(...) method.
  • Integrated notifyTaskStatus into McpServer.
  • Added McpServer support for sampling/createMessage.
  • Exposed onError handler setter/getter on McpServer.
• StreamableMcpServer:
  • Added StreamableMcpServer class for simplified Streamable HTTP server creation (handles serverFactory, event store, and connection management).
• Client Enhancements:
  • Added onTaskStatus callback to Client.
  • Simplified client request handlers for sampling and elicitation.

Fixes #

• Fixed Task serialization.
• Fixed capabilities recognition in McpServer.
• Added comprehensive tests for StreamableMcpServer and Task features.

• Fix pana analysis issues
• Fix Web support for StreamableHTTP client

• Fix Documentation links in README.md

• Update protocol version to 2025-06-18
• Add Elicitation support (server-initiated input collection)
  • API: McpServer.elicitUserInput() (server) | Client.onElicitRequest (client handler)
  • Types: ElicitRequestParams (message, requestedSchema), ElicitResult (action, content), ClientCapabilitiesElicitation
  • Uses elicitation/create method (Inspector-compatible)
  • Accepts JSON Schema Maps for flexible schema definition
  • Helpers: .accepted, .declined, .cancelled getters on ElicitResult
  • Example: elicitation_http_server.dart
  • Tests: elicitation_test.dart
• CRITICAL FIX: Logger → stderr (prevents JSON-RPC corruption in stdio)
• Comprehensive Test Coverage: Added 203 new tests across 4 phases (+13.1% overall coverage: 56.9% → 70.0%)
  • Phase 1: External API coverage (Server MCP, URI templates, Client/Server capabilities) - 108 tests
  • Phase 2: Transport coverage (Stdio, SSE, HTTPS) - 38 tests
  • Phase 3: Types & edge cases (Protocol lifecycle, error handling) - 45 tests
  • Phase 4: Advanced scenarios (Protocol timeouts/aborts, Streamable HTTPS integration) - 12 tests
  • Fixed critical URI template variable duplication bug
  • Fixed McpError code preservation in request handlers
  • All 351 tests passing ✅

• Add support for Completions capability per MCP 2025-06-18 spec
• Add ServerCapabilitiesCompletions class for explicit completions capability declaration
• Update ServerCapabilities to include completions field
• Update client capability check to use explicit completions capability instead of inferring from prompts/resources
• Add integration tests and example for completions capability usage

• Fix issue with StreamableHTTP server not setting correct content-type for SSE

• Replace print statements with lightweight logging implementation

• Remove trailing CR before processing the lines

• Fix issue with CallToolResult not including metadata

• Add ToolInputSchema and ToolOutputSchema support in server.tool()
• Deprecate inputSchemaProperties and outputSchemaProperties in server.tool()
• Update examples to use ToolInputSchema and ToolOutputSchema

• Support Web Client for StreamableHTTP

• Preserve required fields in ToolInputSchema

• Add support for OutputScheme (https://modelcontextprotocol.io/specification/draft/server/tools#output-schema)

• Protocol version 2025-03-26

• Fix SSE behavior on StreamableHTTP
• Added sendNotification and sendRequest to extra for server callbacks

• Add Tool Annotation
• Remove additionalProperties from all models
• Add AudioContent

• Add IOStreamTransport to connect a client and server via dart streams in a single application

• Add support for StreamableHTTP client
• Add support for StreamableHTTP server

• Improve pub.flutter-io.cn points

• Lower min dart sdk to 3.0.0

• Fix Sampling result parsing error

• Add Gemini MCP Client Example
• Add Anthropic MCP Client Example
• Add Weather MCP Server Example

• Add SSE Server Manager for easier SSE server implementation

• Add Client support (stdio)
• Add resource and prompts example to stdio server and client

• Full refactor of the codebase to match it with the Typescript SDK implementation.

• Make it no need to call trasnport.connect()

• Add examples visible in pub.flutter-io.cn

• Add SSE support

• Expose more types

• Initial version.