feat(mcp, cargo-shuttle): The Shuttle MCP Server (#2074)

* mcp init

* refactor

* stdio fix

* deploy

* cwd

* deployment

* logs and project related commands

* resources and certificates commands

* mcp rename

* mcp installation guide

* packages fixed

* removed commands

* delete todo file

* readme update

* search docs tool added

* cwd

* execute_command cwd

* check version

* deployment refactored

* tools refactored

* Version checking

* Constants

* mcp patch

* fixes MCP server arguments for some tools

* constants updated

* readme updated

* docs

* docs updated
version updated

* constants fixed

* version checks

* version set to 0.55.0

* README.md updated

* mcp dir moved to cargo-shuttle

* mcp code moved to shuttle cli

* features added for rmcp

* removed main.rs

* removed mcp server crate

* upgrade shuttle command updated

* removed version checking in the mcp server

* mcp library crate

* removed mcp/ dir in cargo-shuttle

* moved mcp code to a library crate

* removed toml dependency

* shuttle-mcp crate version -> 0.55.0

* removed unnecessary mcp tools

* reduced commands/args

* linter error fixed

* added `id` arg for some mcp tools

* deployment list removed args

* MCP server subcommand changed

* nits, fix argument lists

* simplify execute_command

* nit: Cargo.toml

* ci: add release job

---------

Co-authored-by: jonaro00 <[email protected]>

Author: dcodesdev

.circleci/config.yml

@@ -497,6 +497,7 @@ workflows:
             parameters:
               path:
                 - common
+                - mcp
           name: publish-<< matrix.path >>
           requires:
             - approve-publish-crates

Cargo.lock

@@ -7,6 +7,7 @@ members = [
   "codegen",
   "common",
   "ifc",
+  "mcp",
   "runtime",
   "service",
 ]
@@ -23,6 +24,7 @@ shuttle-api-client = { path = "api-client", version = "0.55.0", default-features
 shuttle-codegen = { path = "codegen", version = "0.55.0" }
 shuttle-common = { path = "common", version = "0.55.0" }
 shuttle-ifc = { path = "ifc", version = "0.55.0" }
+shuttle-mcp = { path = "mcp", version = "0.55.0" }
 shuttle-service = { path = "service", version = "0.55.0" }
 
 anyhow = "1.0.66"
@@ -66,6 +68,7 @@ reqwest = { version = "0.12.14", default-features = false, features = [
 ] }
 reqwest-middleware = "0.4.0"
 rexpect = "0.6.0"
+rmcp = { version = "0.1.5", features = ["server", "transport-io"] }
 semver = { version = "1.0.17", features = ["serde"] }
 serde = { version = "1.0.148", default-features = false }
 serde_json = "1.0.89"
@@ -89,6 +92,7 @@ trybuild = "1.0.72"
 typeshare = "1.0.3"
 utoipa = "5"
 url = "2.5.4"
+urlencoding = "2.1.3"
 walkdir = "2.3.3"
 webbrowser = "1.0.1"
 zeroize = "1.6.0"

Cargo.toml

@@ -12,6 +12,7 @@ default-run = "shuttle"
 shuttle-api-client = { workspace = true, default-features = true }
 shuttle-common = { workspace = true, features = ["models", "tables", "config"] }
 shuttle-ifc = { workspace = true }
+shuttle-mcp = { workspace = true }
 
 anyhow = { workspace = true }
 async-trait = { workspace = true }

cargo-shuttle/Cargo.toml

@@ -161,6 +161,15 @@ pub enum Command {
         #[arg(long)]
         preview: bool,
     },
+    /// Commands for the Shuttle MCP server
+    #[command(subcommand)]
+    Mcp(McpCommand),
+}
+
+#[derive(Subcommand)]
+pub enum McpCommand {
+    /// Start the Shuttle MCP server
+    Start,
 }
 
 #[derive(Subcommand)]

cargo-shuttle/src/args.rs

@@ -58,7 +58,7 @@ use zip::write::FileOptions;
 
 use crate::args::{
     CertificateCommand, ConfirmationArgs, DeployArgs, DeploymentCommand, GenerateCommand, InitArgs,
-    LoginArgs, LogoutArgs, LogsArgs, OutputMode, ProjectCommand, ProjectUpdateCommand,
+    LoginArgs, LogoutArgs, LogsArgs, McpCommand, OutputMode, ProjectCommand, ProjectUpdateCommand,
     ResourceCommand, SecretsArgs, TableArgs, TemplateLocation,
 };
 pub use crate::args::{Command, ProjectArgs, RunArgs, ShuttleArgs};
@@ -301,6 +301,9 @@ impl Shuttle {
                 ProjectCommand::Link => Ok(()), // logic is done in `load_project` in previous step
             },
             Command::Upgrade { preview } => update_cargo_shuttle(preview).await,
+            Command::Mcp(cmd) => match cmd {
+                McpCommand::Start => shuttle_mcp::run_mcp_server().await,
+            },
         }
     }
 

cargo-shuttle/src/lib.rs

@@ -0,0 +1,14 @@
+[package]
+name = "shuttle-mcp"
+version = "0.55.0"
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+
+[dependencies]
+anyhow = { workspace = true }
+reqwest = { workspace = true, features = ["json"] }
+rmcp = { workspace = true, features = ["server", "transport-io"] }
+serde = { workspace = true }
+tokio = { workspace = true, features = ["full"] }
+urlencoding = { workspace = true }

mcp/Cargo.toml

@@ -0,0 +1,2 @@
+pub const SHUTTLE_DOCS_SEARCH_BASE_URL: &str =
+    "https://09ga7allme.execute-api.eu-west-2.amazonaws.com/prod";

mcp/src/constants.rs

@@ -0,0 +1,14 @@
+use rmcp::{transport::stdio, ServiceExt};
+
+use crate::mcp::ShuttleMcpServer;
+
+mod constants;
+mod mcp;
+mod tools;
+mod utils;
+
+pub async fn run_mcp_server() -> Result<(), anyhow::Error> {
+    let service = ShuttleMcpServer.serve(stdio()).await?;
+    service.waiting().await?;
+    Ok(())
+}