Neva

基本能力

产品定位

Neva 是一个用于 Rust 的 MCP 服务器 SDK，旨在简化 MCP 服务器的开发过程，提供易于配置的工具和资源映射功能。

核心功能

1. 工具映射：通过 #[tool] 宏定义工具，提供特定功能（如示例中的 hello 工具）。
2. 资源映射：通过 #[resource] 宏定义资源，提供资源访问功能（如示例中的 get_res 资源）。
3. 提示映射：通过 #[prompt] 宏定义提示，用于代码分析或其他交互功能（如示例中的 analyze_code 提示）。
4. 配置选项：支持通过 with_options 方法配置服务器名称、版本和通信方式（如 stdio）。

适用场景

1. 快速开发 MCP 服务器：适用于需要快速构建 MCP 服务器的开发者。
2. 工具和资源管理：适用于需要管理工具和资源的应用场景。
3. 代码分析：适用于需要代码分析或交互式提示的场景。

工具列表

1. hello 工具：提供简单的问候功能，输入名称后返回问候语。
2. get_res 资源：提供资源访问功能，返回资源 URI 和详细信息。
3. analyze_code 提示：提供代码分析功能，返回语言类型和用户信息。

常见问题解答

1. 项目状态：当前为预览版，可能存在不兼容的变更。

使用教程

使用依赖

在 Cargo.toml 中添加以下依赖：

[dependencies]
neva = { version = "0.0.2", features = ["full"] }
tokio = { version = "1", features = ["full"] }

安装教程

1. 创建一个新的 Rust 项目： bash cargo new neva_server cd neva_server
2. 在 Cargo.toml 中添加上述依赖。
3. 在 src/main.rs 中编写代码（参考示例代码）。
4. 运行项目： bash cargo run

调试方式

1. 确保所有工具、资源和提示已正确映射。
2. 使用 cargo run 启动服务器并观察输出。
3. 检查日志或错误信息以排查问题。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。