litemcp

Le framework MCP le plus rapide et le plus léger au monde — écrit en Rust.

Stateless · socket bindé · Streamable HTTP uniquement (POST/SSE) · zéro runtime async

[!IMPORTANT] 0.1.0 — socle fonctionnel. Le serveur HTTP stateless (bind + POST → JSON/SSE) fonctionne et est testé (14 tests sur vraies sockets). Les macros #[tool] et les schémas dérivés arrivent en 0.2 ; la conformance officielle MCP est visée pour 1.0.

Sommaire

• Pourquoi litemcp
• Quand choisir litemcp plutôt que rmcp
• Installation
• Démarrage rapide
• Tester
• Concepts
• Protocole
• Benchmarks
• Tests
• FAQ
• Feuille de route
• Licence

Pourquoi litemcp

Un serveur MCP en Rust, aujourd'hui, c'est un choix entre deux poids lourds : rmcp, l'officiel — excellent, mais il embarque tokio, hyper, tower et schemars — et fastmcp_rust, qui exige un nightly épinglé et un runtime maison. Les deux sont conçus pour des serveurs de production riches.

litemcp prend le problème par l'autre bout : un serveur MCP qui ne coûte presque rien.

• une CLI qui expose trois outils ;
• un test unitaire qui veut un vrai serveur, sans runtime ;
• un binaire embarqué (edge, IoT) où une pile HTTP complète, c'est non ;
• un agent qui spawn cinquante serveurs et paie le coût à chaque fois.

litemcp traite le protocole comme une bibliothèque, pas comme un service. Le cœur est une pompe JSON-RPC sur des threads bloquants du std — pas de tokio, pas de hyper, pas de schemars : rien que serde.

Les principes :

1. Streamable HTTP uniquement. Un seul transport : un socket TCP bindé ; chaque message est un POST /mcp auto-suffisant, la réponse arrive en application/json ou en flux SSE (text/event-stream, request-scoped). Pas de session, pas d'initialize obligatoire, pas de flux permanent. C'est la spec 2026-07-28, à la lettre.
2. Zéro runtime async au cœur. std::net::TcpListener, un thread par connexion. Un adaptateur tokio existera un jour — en feature optionnelle, jamais par défaut.
3. Deux dépendances, pas une de plus. serde et serde_json. Le JSON Schema sera dérivé à la maison (0.2).
4. Mesuré ou rien. Chaque release publie RSS, taille de binaire et latence p99 — avec rmcp mesuré à plat à côté. Jamais d'adjectif sans chiffre.

Quand choisir litemcp plutôt que rmcp

rmcp est excellent — litemcp ne cherche pas à le remplacer partout. litemcp occupe le créneau que la pile officielle ne peut pas occuper sans casser sa compatibilité tokio : le serveur MCP stateless, minuscule et mesuré.

Installation

# Phase 5 — publication crates.io en cours
[dependencies]
litemcp = "0.1"

En attendant la publication, la dépendance se prend par git :

[dependencies]
litemcp = { git = "https://github.com/DeamonDev888/litemcp" }

Démarrage rapide

use litemcp::prelude::*;

fn main() -> std::io::Result<()> {
    ServerBuilder::new("calc", "1.0.0")
        .tool("add", "Additionne deux nombres", |args| {
            let a = args["a"].as_i64().ok_or("a manquant")?;
            let b = args["b"].as_i64().ok_or("b manquant")?;
            Ok(serde_json::json!({ "somme": a + b }))
        })
        .bind("127.0.0.1:8080")?   // socket bindé, un thread par connexion
        .serve()                    // bloque : POST /mcp → JSON ou SSE
}

C'est tout — votre serveur MCP écoute. Aucune session, aucun handshake, aucun runtime.

Tester

curl -s http://127.0.0.1:8080/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"add","arguments":{"a":5,"b":7}}}'

{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"{\"somme\":12}"}],"structuredContent":{"somme":12}}}

Ou avec MCP Inspector en mode URL : npx @modelcontextprotocol/inspector → http://127.0.0.1:8080/mcp.

Concepts

Outils

Un outil se déclare par une closure — nom, description, fonction :

.tool("search", "Recherche un dossier (référence générique)", |args| {
    let query = args["query"].as_str().ok_or("query manquant")?;
    Ok(serde_json::json!({ "hits": search(query) }))
})

La valeur de retour devient structuredContent ; une Err(msg) devient un isError: true avec le message en contenu texte — les deux niveaux d'erreur de la spec, sans confusion.

La macro #[tool] (0.2) remplacera la closure par une simple fonction annotée, schéma dérivé automatiquement.

Erreurs

• Erreur d'outil (le tool a tourné et a échoué) → CallToolResult::isError — le client affiche le message ;
• Erreur de protocole (mauvaise requête, outil inconnu, JSON invalide) → erreur JSON-RPC typée (-32700, -32602, -32601…), rendue de façon opaque.

Protocole

Benchmarks

Règle du projet : jamais d'adjectif sans chiffre. Les cibles ci-dessous sont des hypothèses de départ ; la première campagne (0.2) les ajuste une fois, puis elles sont figées comme SLO et republiées à chaque release, avec rmcp mesuré dans les mêmes conditions.

Tests

cargo test                          # 18 tests : unitaires + intégration (vraies sockets)
cargo clippy -- -D warnings         # CI stricte

FAQ

Pourquoi un seul transport ? Parce qu'un serveur lancé comme sous-processus d'un client meurt avec lui et n'accepte qu'un seul pair — c'est le modèle du client, pas du serveur. litemcp fait le choix inverse : le serveur est un démon Streamable HTTP stateless, bindé sur un socket TCP, que plusieurs agents peuvent joindre, qui survit aux clients et se déploie derrière nginx. Pour du MCP local en sous-processus, utilisez rmcp.

Pourquoi pas de tokio ? Un serveur MCP mono-outil n'a pas besoin d'un runtime async complet pour lire des requêtes et répondre du JSON. Le thread par connexion suffit jusqu'à des centaines de connexions — et l'adaptateur tokio restera disponible pour les autres cas.

Pourquoi ne pas contribuer à rmcp ? rmcp est le SDK officiel : il doit couvrir toute la spec pour tout le monde, sur tokio, tous transports confondus. Cette contrainte impose son poids. litemcp explore la question inverse : que reste-t-il quand on retire tout ce qui n'est pas strictement nécessaire à un serveur HTTP stateless ?

Pourquoi réécrire HTTP ? Le périmètre est volontairement minuscule : une route POST, Content-Length, keep-alive, un writer SSE mono-événement. Pas de chunked entrant, pas de TLS, pas de compression. Si le périmètre s'avère piégeux, le repli documenté est tiny_http — la décision sera tranchée par les tests, pas par le dogme.

Quand sur crates.io ? Maintenant : 0.1.0 est publié comme socle. La mention « 1.0 » attendra la conformance officielle MCP verte.

Feuille de route

Le détail — jalons, SLO, risques, journal : docs/ROADMAP.md.

Licence

MIT OR Apache-2.0 — LICENSE-MIT · LICENSE-APACHE