Neva

🚀 Neva

Neva是一個易於配置的Rust MCP服務器和客戶端SDK，為開發者提供便捷的MCP開發體驗。

⚠️ 重要提示

該項目目前處於預覽階段。可能會引入破壞性更改，恕不另行通知。

API文檔 | 示例

🚀 快速開始

本項目提供了MCP客戶端和MCP服務器的使用示例，以下是詳細的配置和代碼示例。

💻 使用示例

MCP客戶端

依賴項

[dependencies]
neva = { version = "0.0.6", features = ["client-full"] }
tokio = { version = "1", features = ["full"] }

代碼

use std::time::Duration;
use neva::Client;
use neva::error::Error;

#[tokio::main]
async fn main() -> Result<(), Error> {
    let mut client = Client::new()
        .with_options(|opt| opt
            .with_stdio("npx", ["-y", "@modelcontextprotocol/server-everything"])
            .with_timeout(Duration::from_secs(5)));
    
    client.connect().await?;

    // 列出工具
    let tools = client.list_tools(None).await?;
    for tool in tools.tools {
        println!("- {}", tool.name);
    }

    // 調用一個工具
    let args = [
        ("message", "Hello MCP!")
    ];
    let result = client.call_tool("echo", Some(args)).await?;
    println!("{:?}", result.content);

    client.disconnect().await
}

MCP服務器

依賴項

[dependencies]
neva = { version = "0.0.6", features = ["server-full"] }
tokio = { version = "1", features = ["full"] }

代碼

use neva::{App, tool, resource, prompt};

#[tool(descr = "一個說Hello的工具")]
async fn hello(name: String) -> String {
    format!("Hello, {name}!")
}

#[resource(uri = "res://{name}", descr = "一些關於資源的詳細信息")]
async fn get_res(name: String) -> (String, String) {
    (
        format!("res://{name}"),
        format!("關於資源的一些細節：{name}")
    )
}

#[prompt(descr = "分析代碼以查找潛在改進")]
async fn analyze_code(lang: String) -> (String, String) {
    (format!("語言：{lang}"), "用戶".into())
}

#[tokio::main]
async fn main() {
    let mut app = App::new()
        .with_options(|opt| opt
            .with_stdio()
            .with_name("示例MCP服務器")
            .with_version("1.0.0"));

    map_hello(&mut app);
    map_get_res(&mut app);
    map_analyze_code(&mut app);

    app.run().await;
}