mcpkit-core 0.5.0

Core types and traits for the Model Context Protocol (MCP)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

# mcpkit-core

Core types and traits for the Model Context Protocol (MCP).

This crate provides the foundational building blocks for the MCP SDK:

- **Protocol types**: JSON-RPC 2.0 request/response/notification types
- **MCP types**: Tools, resources, prompts, tasks, content, sampling, elicitation
- **Capability negotiation**: Client and server capabilities
- **Error handling**: Unified `McpError` type with rich diagnostics
- **Typestate connection**: Compile-time enforced connection lifecycle
- **OAuth 2.1 / PKCE**: Authentication primitives

## Runtime Agnostic

This crate does not depend on any async runtime. It can be used with Tokio, smol, or any other executor.

## Protocol Version

Implements MCP protocol version **2025-11-25** with backward compatibility for **2024-11-05**.

## Usage

```rust
use mcpkit_core::{
    types::{Tool, ToolOutput, Content},
    capability::{ServerCapabilities, ServerInfo},
};

// Create a tool definition
let tool = Tool::new("search")
    .description("Search the database")
    .input_schema(serde_json::json!({
        "type": "object",
        "properties": {
            "query": { "type": "string" }
        },
        "required": ["query"]
    }));

// Create server capabilities
let caps = ServerCapabilities::new()
    .with_tools()
    .with_resources()
    .with_tasks();

// Create server info
let info = ServerInfo::new("my-server", "1.0.0");
```

## Feature Flags

- `fancy-errors` - Enable miette's fancy error reporting with terminal colors

## Part of mcpkit

This crate is part of the [mcpkit](https://crates.io/crates/mcpkit) SDK. For most use cases, depend on `mcpkit` directly rather than this crate.

## License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.