reasonkit-web 0.1.0

Web sensing and browser automation layer for ReasonKit - MCP sidecar with headless browser control
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91

<div align="center">

<!-- Hero Banner - Web Sensing Layer -->
<img src="https://raw.githubusercontent.com/ReasonKit/reasonkit-core/main/brand/banners/cognitive-engine.png" alt="ReasonKit Web" width="100%" style="border-radius: 12px;">

# ReasonKit Web

**High-Performance Web Sensing & Browser Automation Layer**

[![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square&color=%23a855f7)](LICENSE)
[![Rust](https://img.shields.io/badge/rust-1.74%2B-orange?style=flat-square&logo=rust)](https://www.rust-lang.org/)
[![MCP](https://img.shields.io/badge/MCP-Compatible-green?style=flat-square&color=%2310b981)](https://modelcontextprotocol.io)

_The Eyes and Ears of AI Reasoning - Now Blazingly Fast_

[ReasonKit Core](https://github.com/ReasonKit/reasonkit-core) | [Documentation](https://reasonkit.sh/docs) | [Website](https://reasonkit.sh)

</div>

---

> **Note:** This is the **Rust implementation** of the ReasonKit Web Sensing layer. It supersedes the legacy Python prototype for performance-critical deployments.

Web sensing and browser automation layer for ReasonKit. Implements the Model Context Protocol (MCP) for seamless web interactions with AI reasoning systems, powered by Rust and ChromiumOxide.

## Features

- **Headless Browser Automation** - Full browser control via ChromiumOxide (CDP)
- **MCP Server** - Model Context Protocol for AI integration
- **Web Capture** - Screenshot, PDF, and HTML capture
- **Content Extraction** - Intelligent content parsing and triangulation
- **High Performance** - Async Rust runtime (Tokio) for low-latency operations

## Quick Start

```bash
# Build the server
cargo build --release

# Run the MCP server
./target/release/reasonkit-web
```

## Architecture

<div align="center">

```
┌─────────────────────────────────────────────────────────────────┐
│                      WEB SENSING LAYER (RUST)                   │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   AI Agent ──▶ MCP Server ──▶ Browser Controller (CDP)         │
│                    │                │                           │
│                    ▼                ▼                           │
│              ┌──────────┐    ┌──────────────┐                   │
│              │ Capture  │    │ Triangulate  │                   │
│              └────┬─────┘    └──────┬───────┘                   │
│                   │                 │                           │
│                   ▼                 ▼                           │
│            Screenshots        Content + Sources                 │
│            PDFs, HTML        Verified Facts                     │
└─────────────────────────────────────────────────────────────────┘
```

</div>

## Technology Stack

| Component         | Technology    | Purpose               |
| ----------------- | ------------- | --------------------- |
| **Browser**       | ChromiumOxide | Async Rust CDP client |
| **MCP Server**    | mcp-sdk-rs    | AI agent integration  |
| **Runtime**       | Tokio         | Async runtime         |
| **Serialization** | Serde         | JSON handling         |

## License

Apache License 2.0 - see [LICENSE](LICENSE)

---

<div align="center">

**Part of the ReasonKit Ecosystem**

[ReasonKit Core](https://github.com/ReasonKit/reasonkit-core) • [ReasonKit Mem](https://github.com/ReasonKit/reasonkit-mem) • [Website](https://reasonkit.sh)

_"See How Your AI Thinks"_

</div>