sery-mcp 0.0.1

The local-files MCP server. Pure Rust. Exposes CSVs, Parquet, Excel, DOCX, PDF, and HTML on the user's machine to any MCP-aware LLM client (Claude Desktop, Cursor, Zed, …).
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

//! `sery-mcp` binary entrypoint.
//!
//! Pre-0.1 bootstrap: prints the build banner to stderr and exits
//! cleanly. The actual MCP handshake (rmcp `ServiceExt::serve` over
//! stdio) + tool registrations land in v0.1.0.
//!
//! Why ship a placeholder rather than a fully working v0.1.0 in the
//! first commit: the MCP tool surface (input schemas, output shapes,
//! error semantics) deserves design review before being baked into
//! crates.io. The skeleton lets us verify the dep graph, license
//! files, and CI compile cleanly first.

use clap::Parser;

#[derive(Parser, Debug)]
#[command(
    name = "sery-mcp",
    version,
    about = "Local-files MCP server. Pure Rust. Read-only by design.",
    long_about = None,
)]
struct Cli {
    /// Folder to expose as the MCP root. Defaults to the current
    /// working directory. Tools that take a `path` argument are
    /// validated to fall under this root — no escaping via `..`.
    #[arg(long, value_name = "DIR")]
    root: Option<std::path::PathBuf>,
}

// Bootstrap binary doesn't yet have any fallible MCP work, but v0.1.0
// will (rmcp's serve loop, file I/O, schema lookups). Keep the Result
// return type now so the signature doesn't churn when real work lands.
#[allow(clippy::unnecessary_wraps)]
fn main() -> anyhow::Result<()> {
    // Subscribe to tracing → stderr. CRITICAL: never log to stdout —
    // stdout is reserved for the MCP transport (JSON-RPC frames).
    tracing_subscriber::fmt()
        .with_writer(std::io::stderr)
        .with_env_filter(
            tracing_subscriber::EnvFilter::try_from_default_env()
                .unwrap_or_else(|_| tracing_subscriber::EnvFilter::new("info")),
        )
        .init();

    let cli = Cli::parse();
    let root = cli
        .root
        .unwrap_or_else(|| std::env::current_dir().expect("CWD must be readable"));

    tracing::info!(
        version = sery_mcp::VERSION,
        root = %root.display(),
        "sery-mcp bootstrap (pre-0.1) — MCP handshake + tools land in v0.1.0"
    );

    eprintln!(
        "sery-mcp v{} — pre-0.1 bootstrap. See https://github.com/seryai/sery-mcp",
        sery_mcp::VERSION
    );

    Ok(())
}