Rs Template

MCPAI代理

提供方 furbyhaxx

AI代理 未标注 无需鉴权 社区 / 第三方

一个用于构建Model Context Protocol (MCP)服务器的Rust模板,提供生产就绪的基础设施、灵活的配置和多种传输支持。

一句话选型结论

按资料字段整理

Rs Template 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 3 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量3暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

Rust开发Rust本地部署服务器模板MCP协议生产就绪多传输支持

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 3 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 3 个工具,职责相对集中,接入后不容易误操作。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Rs Template当前 3 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方furbyhaxx上游标注的维护方 furbyhaxx
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

13.5 KB
来自项目仓库与上游目录的原文,未做删改

Rust MCP服务器启动模板

🎉 现在货物生成兼容! 使用单个命令生成自定义MCP服务器。

用于构建的生产就绪、记录良好的入门模板 模型上下文协议(MCP) Rust中的服务器。此模板提供了一个完整的基础,包括工作示例、生产日志和灵活的配置。

✨ 特性

  • 🚀 生产就绪:通过全面的错误处理和日志记录完成实施
  • 🔧 灵活的配置:TOML文件+环境变量+CLI参数(基于图形)
  • 📝 结构化日志记录:具有文件轮换和多个输出的生产日志记录(跟踪生态系统)
  • 🌐 多个传输:
  • 标准 子进程通信传输
  • HTTP/SSE 优雅关机的网络通信传输
  • 🛠️ 完整的MCP支持:
  • 工具:具有参数和结构化响应的可调用函数
  • 资源:服务器元数据的只读数据访问
  • 提示:人工智能助手交互的用户控制模板
  • 📊 示例实现:
  • 回声工具(简单的字符串输入/输出)
  • 计算器工具(带JSON结果的结构化参数)
  • 状态计数器工具(演示与共享的状态 Arc>)
  • 🏗️ 模块化架构:库+二进制模式,便于扩展和测试
  • 🧪 综合测试:两种运输工具的单元测试和集成测试

🚀 快速开始

先决条件

  • 锈蚀1.85+ (Rust 2024版)
  • 货物

🚀 快速开始

推荐:使用货物生成```bash

Install cargo-generate if you don't have it

cargo install cargo-generate

Generate your custom MCP server

cargo generate --git https://github.com/furbyhaxx/mcp-server-rs-template

Follow the prompts to customize your project!


### 手动安装```bash
# Clone the template
git clone https://github.com/yourusername/rmcp-starter-template.git
cd rmcp-starter-template

# Build the project
cargo build --release

# Run with stdio transport (default)
cargo run -- serve

# Run with explicit transport selection
cargo run -- serve --transport stdio
cargo run -- serve --transport http

测试工具

运行后,您可以与内置工具进行交互:

回声工具:```bash

Example MCP client interaction (simplified)

{
"tool": "echo",
"arguments": {
"message": "Hello, MCP!"
}
}

Returns: "Echo: Hello, MCP!"


**计算器工具:**```bash
{
"tool": "calculate",
"arguments": {
"a": 10.5,
"b": 5.2,
"operation": "add"
}
}
# Returns: {"result": 15.7, "operation": "add", "operands": [10.5, 5.2]}

计数器工具:```bash
{
"tool": "get_counter"
}

Returns: "Current counter value: 0"

{
"tool": "increment_counter",
"arguments": {
"amount": 3
}
}

Returns: "Counter incremented by 3. New value: 3"

{
"tool": "reset_counter"
}

Returns: "Counter reset to 0"


## ⚙️ 配置

该模板支持三层配置(按优先级顺序):

1. **CLI参数** (最高优先级)
1. **环境变量** (前缀: `MCP_`)
1. **TOML文件** (默认值: `config/default.toml`)

### 配置文件

- **`config/default.toml`**:具有合理默认值的默认配置
- **`.env.example`**:环境变量模板

### 环境变量```bash
# Override server name
MCP_SERVER_NAME="my-mcp-server"

# Set log level to debug
MCP_LOGGING_LEVEL="debug"

# Configure HTTP transport port
MCP_TRANSPORT_HTTP_PORT="8080"

# Use only console logging (no file output)
MCP_LOGGING_TARGETS="console"

CLI使用情况```bash

Run with custom transport

cargo run -- serve --transport http

View help and all options

cargo run -- --help


## 🏗️ 建筑

### 项目结构```
rmcp-starter-template/
├── src/
│   ├── lib.rs                    # Public library API with prelude
│   ├── main.rs                   # CLI entry point
│   ├── cli.rs                    # Command-line interface (clap)
│   ├── config/                   # Configuration management (figment)
│   │   ├── mod.rs               # Config struct and loading logic
│   │   └── tests.rs             # Configuration tests
│   ├── logging/                  # Production logging setup (tracing)
│   │   └── mod.rs               # Logging initialization with rotation
│   ├── transport/                # Transport layer
│   │   ├── mod.rs               # Transport factory and abstraction
│   │   ├── stdio.rs             # stdio transport implementation
│   │   └── http.rs              # HTTP/SSE transport implementation
│   ├── service.rs                # MCP service with tools/resources/prompts
│   ├── service/
│   │   ├── tools.rs             # Tool parameter types and schemas
│   │   ├── resources.rs         # Resource implementations
│   │   ├── prompts.rs           # Prompt implementations
│   │   └── tests.rs             # Service tests
│   ├── error.rs                  # Comprehensive error handling (thiserror)
│   └── prelude.rs                # Common imports for convenience
├── config/
│   └── default.toml             # Default configuration
├── tests/                       # Integration tests
│   ├── stdio_integration.rs     # stdio transport tests
│   └── http_integration.rs      # HTTP transport tests
├── .env.example                 # Environment variable template
└── CHANGELOG.md                 # Version history

运输工厂模式

该模板使用传输工厂模式进行扩展:```rust
// Dynamic transport creation
let transport_future = create_transport(transport, &config, service)?;

// Supports both stdio and HTTP transports
match transport {
Transport::Stdio => stdio::serve(service).await,
Transport::Http => http::serve(service, &config).await,
}


## 🔧 扩展模板

### 添加新工具

1. **定义参数** (可选,用于结构化输入):```rust
// In src/service/tools.rs
use rmcp::schemars::JsonSchema;
use serde::{Deserialize, Serialize};

#[derive(Debug, Deserialize, Serialize, JsonSchema)]
pub struct MyToolParams {
/// Input text to process
pub input: String,
/// Optional processing mode
pub mode: Option,
}
  1. 机具功能:```rust
    // In src/service.rs
    use rmcp_starter_template::service::tools::MyToolParams;

[tool(description = "Process input text with optional mode")]

pub async fn my_tool(&self, #[arg] params: MyToolParams) -> Result {
let mode = params.mode.as_deref().unwrap_or("default");
let result = format!("Processed '{}' with mode '{}'", params.input, mode);

Ok(CallToolResult::success(vec![Content::text(result)]))
}


3. **工具被自动发现** 通过 `#[tool]` 宏

### 添加新资源```rust
// In src/service.rs, override the ServerHandler methods
async fn list_resources(&self) -> Result>, Error> {
vec![
Annotated::new(
RawResource::new("my://resource".into(), "My custom resource".into()),
),
]
}

async fn read_resource(&self, uri: &str) -> Result {
match uri {
"my://resource" => {
let content = Content::text("This is my resource content".to_string());
Ok(ReadResourceResult {
contents: vec![content],
})
}
_ => Err(Error::invalid_params("Unknown resource URI")),
}
}

添加新提示```rust

// In src/service.rs, extend the ServerHandler implementation
async fn list_prompts(&self) -> Result>, Error> {
vec![
Annotated::new(Prompt {
name: "my_prompt".into(),
description: Some("My custom prompt template".into()),
arguments: vec![
PromptArgument {
name: "topic".into(),
description: Some("The topic to discuss".into()),
required: Some(true),
},
],
}),
]
}

async fn get_prompt(&self, name: &str, arguments: Option) -> Result {
match name {
"my_prompt" => {
let args = arguments.ok_or_else(|| Error::invalid_params("Arguments required"))?;
let topic = args.arguments
.get("topic")
.and_then(|v| v.as_str())
.ok_or_else(|| Error::invalid_params("Missing 'topic' argument"))?;

let message = PromptMessage {
role: PromptRole::User,
content: Content::text(format!("Tell me about {}", topic)),
};

Ok(GetPromptResult {
description: Some(format!("Prompt about {}", topic)),
messages: vec![message],
})
}
_ => Err(Error::invalid_params("Unknown prompt name")),
}
}


### 添加新传输

1. **创建传输模块** 在 `src/transport/my_transport.rs`
1. **实现服务功能**:```rust
pub async fn serve(service: S) -> Result<()>
where
S: ServerHandler + Send + Sync + Clone + 'static,
{
// Your transport implementation here
todo!("Implement your transport")
}
  1. 添加枚举变量 到 Transport 枚举在 src/cli.rs
  2. 更新出厂功能 在 src/transport/mod.rs

🧪 发展

建筑```bash

cargo build
cargo build --release # Optimized release build


### 测试```bash
# Run all tests
cargo test

# Run specific test
cargo test test_config_loading

# Run with output
cargo test -- --nocapture

# Run integration tests only
cargo test --test integration

代码质量```bash

Format code

cargo fmt

Run linter (will fail on warnings)

cargo clippy -- -D warnings

Check for formatting issues

cargo fmt -- --check

Generate documentation

cargo doc --open


### 开发工作流程示例```bash
# 1. Create development configuration
cp .env.example .env
echo 'MCP_LOGGING_LEVEL="debug"' >> .env
echo 'MCP_LOGGING_TARGETS="console"' >> .env

# 2. Run with console logging for development
cargo run -- serve --transport stdio

# 3. Test changes
cargo test

# 4. Run quality checks
cargo fmt && cargo clippy -- -D warnings

🔍 故障排除

常见问题

“不支持传输”错误:

  • 确保您正在使用 --transport stdio 或 --transport http
  • 检查运输模块是否正确导入

配置未加载:

  • 验证中的TOML语法 config/default.toml
  • 检查环境变量名称的使用情况 MCP_ 前缀
  • 使用 RUST_LOG=debug 查看配置加载详细信息

日志未显示:

  • 存放WorkerGuard: let _guard = init_logging(&config)?;
  • 检查日志级别:设置 MCP_LOGGING_LEVEL=debug 用于详细输出
  • 验证日志目标: MCP_LOGGING_TARGETS=console+file

日志文件位置

  • 默认: logs/mcp-server.log (相对于项目根)
  • 可定制的:设置 MCP_LOGGING_FILE 环境变量
  • 旋转:默认情况下为每日,通过配置 MCP_LOGGING_ROTATION

获取帮助

  • 依赖指南:参见 .agents/instruction/external-dependencies/ 有关所有依赖关系的详细信息
  • MCP规范: 模型上下文协议规范
  • rmcp文件: 官方Rust SDK

调试模式```bash

Enable debug logging

RUST_LOG=debug cargo run -- serve

Show configuration details

MCP_LOGGING_LEVEL=debug cargo run -- serve


## 📚 文档

- **API库文档**:由源代码生成
- **依赖指南**:所有外部依赖关系的全面指南
- **更改日志.md**:版本历史和更改

## 🛠️ 依赖项

|依赖关系|版本|目的|文档|
|------------|---------|---------|---------------|
| **rmcp** |0.8.5|MCP协议实现| 指南 |
| **拍手** |4.5.53|CLI参数解析| 指南 |
| **虚构** |0.10.19|配置管理| 指南 |
| **东京** |1.48.0|异步运行时| 指南 |
| **追踪** |0.1.41|结构化日志记录| 指南 |
| **追踪订户** |0.3.20 |日志格式化/过滤| 指南 |
| **追踪附录** |0.2.3 |带旋转的文件记录| 指南 |
| **这个错误** |2.0.17|错误处理| 指南 |
| **序列化与反序列化** |1.0.228|序列化|标准库|
| **Serde JSON** |1.0.145|JSON处理|标准库|
| **东京-有用** |0.7.17|异步实用程序(用于取消令牌)|标准库|

## 🤝 贡献

欢迎投稿!拜托:

1. 复刻仓库
1. 创建要素分支(`git checkout -b feature/amazing-feature`)
1. 遵循Rust 2024惯例
1. 添加新功能的测试
1. 更新文档
1. 跑 `cargo fmt && cargo clippy -- -D warnings && cargo test`
1. 提交拉取请求

### 代码风格

- 使用 `cargo fmt` 用于格式化
- 使用 `cargo clippy -- -D warnings` 用于棉绒(不允许警告)
- 遵循Rust 2024版本约定
- 添加 `///` 所有公共API的文档
- 在有帮助的地方包括doctest示例

## 📄 许可证

根据以下任一方式获得许可:

- Apache许可证,版本2.0(特许通行证 或http://www.apache.org/licenses/LICENSE-2.0)
- MIT许可证(许可证-麻省理工学院 或http://opensource.org/licenses/MIT)

由您选择。

## 🎨 模板定制

此模板支持通过以下方式进行广泛的自定义 货物生成:

### 可用的自定义设置

- **项目配置**:姓名、描述、作者、许可证
- **运输选项**:stdio,带可配置端口的HTTP
- **工具选择**:选择要包含的示例工具
- **日志记录设置**:日志级别、文件日志记录、轮换
- **功能标志**:可选组件和功能
- **开发vs生产**:优化了每个环境的默认值

### 自定义示例```bash
# Minimal CLI server
cargo generate --git https://github.com/furbyhaxx/mcp-server-rs-template \
--enable-http-transport=false \
--enable-file-logging=false

# Full-featured HTTP server
cargo generate --git https://github.com/furbyhaxx/mcp-server-rs-template \
--default-transport http \
--http-port 8080 \
--enable-all-features

# Production-ready setup
cargo generate --git https://github.com/furbyhaxx/mcp-server-rs-template \
--log-level warn \
--author-name "Production Team" \
--license MIT

📖 获取完整的自定义选项,请参阅 模板_USAGE.md

🔗 资源

  • 模型上下文协议规范:官方MCP协议规范
  • MCP官方文件:MCP通用文件和指南
  • rmcp GitHub仓库:官方Rust MCP实现
  • Rust 2024版指南:最新的Rust特性和约定
  • 货物生成:模板生成工具

🙏 致谢

内置于 rmcp,模型上下文协议的官方Rust实现,由 货物生成 便于定制。


版本: 0.1.0
状态:生产就绪✅

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Rs Template 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Rs Template 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Rs Template 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Rs Template 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Rs Template 能提供哪些能力?

资料显示约 3 个工具;能力标签包括 Rust、服务器模板、生产就绪。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。