Struct DevTools 

pub struct DevTools { /* private fields */ }

Available on non-WebAssembly only.

What DevMcpExt::dev_mcp_with mounts, and when.

use rust_web_server::app::App;
use rust_web_server::dev_mcp::{DevMcpExt, DevTools};

let app = App::with_state(()).dev_mcp_with(
    DevTools::new()
        .token_env("APP_DEV_TOKEN") // instead of MCP_TOKEN
        .with_ops()                 // the rws binary's 25 tools too
        .read_only(),               // but nothing that changes state
);

Implementations

impl DevTools

pub fn new() -> DevTools

The defaults: server rws-dev, endpoint /mcp, RWS_ENV and MCP_TOKEN from the environment, changing tools included, requests recorded for recent_requests, no operations tools, no database.

pub fn server_info( self, name: impl Into<String>, version: impl Into<String>, ) -> DevTools

serverInfo the endpoint reports (default rws-dev and the rws version).

pub fn at(self, path: impl Into<String>) -> DevTools

The endpoint’s path (default /mcp) — for an app that serves its own MCP server there.

pub fn env(self, env: RwsEnv) -> DevTools

Decide as if RWS_ENV were env instead of reading it.

pub fn token(self, token: impl Into<String>) -> DevTools

Require this bearer token (and mount the endpoint in any environment). An empty or blank token counts as none.

pub fn token_env(self, name: impl Into<String>) -> DevTools

Read the token from this environment variable instead of MCP_TOKEN (DEFAULT_TOKEN_ENV); Self::token wins over it.

pub fn read_only(self) -> DevTools

Leave out every tool that changes something (OPS_WRITE_TOOLS, DEV_WRITE_TOOLS): the agent can look, not act.

pub fn with_ops(self) -> DevTools

Mount the rws binary’s operations tools as well (ops_tools): metrics, rate limits, CORS, static files, maintenance mode, the IP blocklist, feature flags, authorization, traffic, config reload.

pub fn cache(self, cache: CacheLayer) -> DevTools

The response cache for the cache_stats / cache_clear operations tools (a clone of the layer the app wraps; clones share the store). Implies Self::with_ops.

pub fn record_requests(self, record: bool) -> DevTools

Whether requests to the app are recorded into the request log that recent_requests / recent_errors read (default true). Turn it off when the app already has a crate::request_log::LogLayer, or each request is listed twice.

pub fn allowed_origins<I, S>(self, origins: I) -> DevTools

where I: IntoIterator<Item = S>, S: Into<String>,

Browser origins allowed to call the endpoint (McpServer::allowed_origins); desktop and CLI clients send no Origin and need none.

pub fn database(self, pool: DbPool) -> DevTools

Available on crate features model-mysql or model-postgres or model-sqlite only.

The database db_schema and the migration tools use.

pub fn migrations(self, dir: impl Into<String>) -> DevTools

Available on crate features model-mysql or model-postgres or model-sqlite only.

The directory of *.sql migrations (crate::model::DbPool::migrate) for migrations (status), migrations_run and migrations_rollback_last. Needs Self::database.

pub fn model<T>(self) -> DevTools

where T: Model,

Available on crate features model-mysql or model-postgres or model-sqlite only.

Report the #[derive(Model)] type T in models: its table, columns and primary key (crate::model::ModelInfo), compared with the database’s table when Self::database is set. Rust can’t list a program’s models at run time, so each is named once; registering one twice lists it once.

pub fn app_dir(self, dir: impl Into<PathBuf>) -> DevTools

The project root layout reads rws.app.toml and the conventional paths from (default: the working directory when the tools are installed). env!("CARGO_MANIFEST_DIR") is the project’s own root in cargo run and cargo test, whatever the working directory — the starters pass it, since they serve static files from another directory.

pub fn enabled(&self) -> bool

Whether Self::mount mounts the endpoint: RWS_ENV=dev, or a token configured.

pub fn register(&self, mcp: McpServer) -> McpServer

Register the tools on mcp, ungated: routes, config, layout, recent_requests, recent_errors, with a model-* feature models, with a database db_schema, with migrations migrations (and migrations_run, migrations_rollback_last unless Self::read_only), and the operations tools with Self::with_ops. The routes are those of the app mcp wraps (McpServer::wrap). For an app that builds its own MCP server and gates it itself; Self::mount is the gated form.

pub fn mount<A>(self, app: A) -> DevMcp<A>

where A: Application + Send + Sync + 'static,

app with the endpoint in front of it when Self::enabled; otherwise app alone, and a one-line notice on stdout.

Trait Implementations

impl Clone for DevTools

fn clone(&self) -> DevTools

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for DevTools

fn default() -> DevTools

Returns the “default value” for a type.