hanzo-mcp-types

Rust type definitions for the Model Context Protocol (MCP).

Overview

This crate provides strongly-typed Rust definitions for all MCP protocol messages, enabling type-safe communication between AI agents and tool servers.

Installation

[dependencies]
hanzo-mcp-types = "0.6"

Usage

use mcp_types::{
    CallToolRequest, CallToolResult, ListToolsRequest, ListToolsResult,
    Tool, ToolInfo, Content, TextContent,
};

// Define a tool
let tool = Tool {
    name: "read_file".to_string(),
    description: Some("Read contents of a file".to_string()),
    input_schema: serde_json::json!({
        "type": "object",
        "properties": {
            "path": {"type": "string"}
        },
        "required": ["path"]
    }),
};

// Create a tool call request
let request = CallToolRequest {
    name: "read_file".to_string(),
    arguments: Some(serde_json::json!({"path": "src/main.rs"})),
};

Key Types

Type	Description
`Tool`	Tool definition with name, description, and JSON schema
`CallToolRequest`	Request to execute a tool
`CallToolResult`	Result from tool execution
`ListToolsRequest`	Request to list available tools
`ListToolsResult`	List of available tools
`Content`	Tool output content (text, image, resource)
`Resource`	External resource reference
`Prompt`	Prompt template definition

Protocol Version

This crate implements MCP specification version 2025-06-18.

TypeScript schema (source of truth): schema.ts
JSON schema: schema.json

Related Crates

hanzo-mcp-client - Async MCP client
hanzo-protocol - Core protocol types
hanzo-zap - Zero-copy Agent Protocol

hanzo-mcp-types 0.6.74