mcps-core 0.1.0

Model Context Protocol Secure (MCPS) - Core protocol implementation
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# MCPS Core

**Model Context Protocol Secure (MCPS) - Core Protocol Implementation**

[![Crates.io](https://img.shields.io/crates/v/mcps-core.svg)](https://crates.io/crates/mcps-core)
[![Documentation](https://docs.rs/mcps-core/badge.svg)](https://docs.rs/mcps-core)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)

MCPS (Model Context Protocol Secure) is "The HTTPS of MCP" - providing enterprise-grade security, encryption, and authentication for Model Context Protocol communications.

## Overview

The `mcps-core` crate provides the foundational protocol implementation for MCPS, including:

- 🔒 **Secure Handshake Protocol** - Automated key exchange and session establishment
- 📦 **Message Framing** - Efficient binary protocol with built-in compression
- 🛡️ **Threat Detection** - Real-time security monitoring and anomaly detection
- 🔐 **Authentication** - Multi-factor authentication and identity verification
- 📊 **Protocol Negotiation** - Automatic capability detection and version management

## Features

- **Zero Configuration**: Automatic protocol detection and transparent upgrade from legacy MCP
- **Pure Rust**: Memory-safe implementation with no OpenSSL dependencies
- **High Performance**: < 100ms handshake time, < 1% overhead vs plain MCP
- **Enterprise Ready**: SOC2 compliance, audit logging, SIEM integration
- **Backward Compatible**: 100% compatibility with existing MCP clients

## Quick Start

```rust
use mcps_core::{Protocol, HandshakeConfig};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Initialize MCPS protocol
    let config = HandshakeConfig::default();
    let protocol = Protocol::new(config);
    
    // Establish secure session
    let session = protocol.handshake().await?;
    
    // Ready for secure MCP communication
    println!("MCPS session established: {}", session.id());
    Ok(())
}
```

## Architecture

MCPS builds on proven cryptographic primitives:

- **Encryption**: ChaCha20-Poly1305 authenticated encryption
- **Key Exchange**: X25519 Elliptic Curve Diffie-Hellman
- **Hashing**: BLAKE3 high-performance cryptographic hash
- **Transport**: TLS 1.3 with modern cipher suites

## Documentation

- [API Documentation](https://docs.rs/mcps-core)
- [MCPS Specification](https://github.com/SamDuchaine/mpcs/blob/master/docs/SPECIFICATION.md)
- [Migration Guide](https://github.com/SamDuchaine/mpcs/blob/master/docs/MIGRATION.md)
- [Security Audit](https://github.com/SamDuchaine/mpcs/blob/master/docs/SECURITY.md)

## Related Crates

- [`mcps-client`](https://crates.io/crates/mcps-client) - MCPS client implementation
- [`mcps-server`](https://crates.io/crates/mcps-server) - MCPS server implementation
- [`mcps-protocol`](https://crates.io/crates/mcps-protocol) - Complete MCPS toolkit

## License

Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.

## Security

For security vulnerabilities, please see our [Security Policy](SECURITY.md) and report issues to security@kindly.dev.