loctree-mcp 0.13.0

MCP server for loctree - hot codebase analysis for AI agents
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
78
79
80
81
82
83
84
85
86
87
88

//! CLI arguments for `loctree-mcp`.
//!
//! Two transport modes:
//!   - `--transport stdio` (default) — line-delimited JSON-RPC over stdio,
//!     for editor / CLI MCP clients.
//!   - `--transport http` — axum server hosting `rmcp::transport::
//!     streamable_http_server::StreamableHttpService` at `/mcp` on `--bind`.
//!     Used by `loct watch --http` co-process and hosted MCP gateways.
//!
//! Vibecrafted with AI Agents by VetCoders (c)2024-2026 LibraxisAI

use clap::Parser;

/// Which transport the server should expose.
#[derive(clap::ValueEnum, Clone, Copy, Debug, PartialEq, Eq)]
pub(crate) enum TransportKind {
    /// Default: serve MCP over stdio (line-delimited JSON-RPC).
    Stdio,
    /// Serve MCP over streamable-http (HTTP POST + SSE event stream)
    /// mounted at `/mcp` on the address from `--bind`.
    Http,
}

#[derive(Parser, Debug)]
#[command(name = "loctree-mcp")]
#[command(about = "Universal MCP server for loctree - works with any project")]
// Build-identity stamp (crate version + git commit, from build.rs), so a
// `loctree-mcp --version` confirms which commit an operator's binary was built
// from after a rebuild/redeploy.
#[command(version = env!("LOCTREE_MCP_BUILD_VERSION"))]
pub(crate) struct Args {
    /// Log level (trace, debug, info, warn, error)
    #[arg(long, default_value = "info")]
    pub(crate) log_level: String,

    /// Which transport the server should expose.
    ///
    /// `stdio` is the long-standing default for editor / CLI MCP clients.
    /// `http` brings up an axum server hosting the streamable-http MCP
    /// surface on `--bind`. Use this when the MCP client wants to connect
    /// over a TCP socket — for example the `loct watch --http` co-process
    /// pattern, or a hosted MCP gateway.
    #[arg(long, value_enum, default_value_t = TransportKind::Stdio)]
    pub(crate) transport: TransportKind,

    /// Bind address for `--transport http`. Defaults to a loopback-only
    /// listener so the server isn't accidentally exposed to the network.
    #[arg(long, default_value = "127.0.0.1:5174")]
    pub(crate) bind: String,

    /// Pin a default project root for this server instance.
    ///
    /// When set, tool calls that omit the per-request `project` field
    /// resolve against this root instead of the server's current working
    /// directory. The per-request `project` parameter still overrides it,
    /// so the server stays "universal" — `--root` only changes the
    /// *default* that empty `project` fields fall back to.
    ///
    /// Used by `loct watch --http`, which spawns this server as a
    /// co-process pinned to the watched repo root. `--project` is an
    /// accepted alias so the launcher and operators can use whichever
    /// name reads clearer at the call site.
    #[arg(long, alias = "project", value_name = "DIR")]
    pub(crate) root: Option<String>,
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn root_flag_parses() {
        let args = Args::parse_from(["loctree-mcp", "--root", "/tmp/x"]);
        assert_eq!(args.root.as_deref(), Some("/tmp/x"));
    }

    #[test]
    fn project_alias_parses_to_root() {
        let args = Args::parse_from(["loctree-mcp", "--project", "/tmp/y"]);
        assert_eq!(args.root.as_deref(), Some("/tmp/y"));
    }

    #[test]
    fn no_root_is_none_universal_mode() {
        let args = Args::parse_from(["loctree-mcp"]);
        assert!(args.root.is_none());
    }
}