A Rust implementation of the Client of the Model Context Protocol (MCP), designed for seamless communication between AI models and their runtime environments.
The ClientBuilder
allows you to spawn a subprocess server easily, attaching to its stdin
and stdout
.
Minimal Working Example:
use mcp_rust_sdk::client::ClientBuilder;
#[tokio::main]
async fn main() -> Result<()> {
let client = ClientBuilder::new("uvx")
.arg("notes-simple")
.spawn_and_initialize().await?;
Ok(())
}
Note this won't work for any remote servers: they're not running locally.
Remote server support is unplanned.
The servers used with this client should implement the protocol to specification.
Tool call responses error out if the wrong schema is used or the server returns an error.
The Client
provides typed methods to interact with the server:
list_resources() -> Result<ListResourcesResult, Error>
call_tool(name, arguments) -> Result<CallToolResult, Error>
read_resource(uri) -> Result<ReadResourceResult, Error>
For example:
let resources = client.list_resources().await?;
println!("Resources: {:?}", resources);
let tool_result = client.call_tool("add-note", serde_json::json!({
"name": "my_first_note",
"content": "This is some note content."
})).await?;
println!("Tool result: {:?}", tool_result);
let read_result = client.read_resource("note://internal/my_first_note").await?;
println!("Read resource: {:?}", read_result);
Contributions are welcome! Please open an issue or submit a PR if you have improvements, bug fixes, or new features to propose.
- Fork the repo
- Create a new branch
- Add your changes and tests
- Submit a Pull Request
Please @ darinkishore in the PR if you do send one over.
This project is licensed under the MIT License. See LICENSE for details.