MCP-开发环境-with-Rust
项目介绍
使用 Rust 学习 MCP 开发：完整的学习资源
██████╗ ███████╗███╗ ███╗ ██████╗ ██╗ █████╗ ██████╗
██╔══██╗██╔════╝████╗ ████║██╔═══██╗██║ ██╔══██╗██╔══██╗
██████╔╝█████╗ ██╔████╔██║██║ ██║██║ ███████║██████╔╝
██╔══██╗██╔══╝ ██║╚██╔╝██║██║ ██║██║ ██╔══██║██╔══██╗
██║ ██║███████╗██║ ╚═╝ ██║╚██████╔╝███████╗██║ ██║██████╔╝
╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝╚═════╝
先进的全球技术解决方案
📚 关于此学习资源
这个全面的学习资源提供了两个完整的教程，帮助您掌握使用 Rust 进行 Model Context Protocol (MCP) 开发。从适合初学者的介绍到生产就绪的企业应用程序，这些教程将引导您完成构建稳健 MCP 服务器的各个方面。
发布者： Remolab - 先进的技术解决方案
作者： Hamze Ghalebi，CTO
🎯 为什么有两个教程版本？
我们创建了两条不同的学习路径，以服务于不同的受众和学习偏好：
📖 版本 1：技术参考指南
文件： mcp_rust_tutorial.md
适合：
- 寻求全面技术文档的经验丰富的开发者
- 在生产环境中实施 MCP 的团队
- 喜欢详细代码示例和 API 参考的开发者
关键特性：
- ✅ 20 个完整的运行示例 - 从 Hello World 到企业系统
- ✅ 超过 3,000 行生产代码 - 实际测试的实现
- ✅ 全面的 Rust 概念 - 高级模式和最佳实践
- ✅ 外部学习资源 - 130 多个精选链接和参考资料
- ✅ 生产部署 - CI/CD、Docker、监控和扩展
- ✅ 行业最佳实践 - 安全性、性能和可维护性
示例项目包括：
- 基本 MCP 服务器（Hello World、计算器、文本处理器）
- 现实世界应用（数据库集成、文件操作、WebSocket 服务器）
- 高级系统（任务队列、认证、通知服务）
- 企业解决方案（搜索引擎、区块链集成、ML 模型服务器）
🌍 版本 2：国际教学指南
文件： mcp_rust_tutorial_international.md
适合：
- 国际学习者和非英语母语者
- 刚接触 Rust 或 MCP 开发的新手
- 寻求结构化、逐步学习的学生
- 教授 Rust 和 MCP 概念的教育工作者
关键特性：
- ✅ 清晰的国际英语 - 适用于全球学习者
- ✅ 结构化的学习路径 - 按技能水平和时间投入组织
- ✅ 教学方法论 - 应用 20 年的教育经验
- ✅ 逐步指导 - 对每个概念进行详细解释
- ✅ 文化敏感性 - 适合全球受众的例子和语言
- ✅ 视觉学习辅助工具 - 表情符号、图表和进度跟踪
学习旅程：
📚 基础知识 (30 分钟) → 核心概念和设置
🏗️ 基础练习 (2 小时) → 第一个工作的 MCP 服务器
⚙️ 中级 (3 小时) → 现实世界应用
🚀 高级 (4 小时) → 生产级系统
🌍 部署 (1 小时) → 全球部署策略
🚀 开始
前提条件
- 安装 Rust 1.70+ (安装指南)
- 基本的终端/命令行知识
- 文本编辑器或 IDE（推荐使用 VS Code 和 rust-analyzer）
快速开始（选择您的路径）
选项 1：从 crates.io 安装（推荐）
# 在 Cargo.toml 中添加依赖项
[dependencies]
mcp_rust_examples = "0.1.0"
# 或全局安装二进制文件
cargo install mcp_rust_examples
# 直接运行示例
example_01_hello_world
example_02_calculator
选项 2：克隆并构建（开发）
# 克隆仓库
git clone https://github.com/RustSandbox/MCP-Development-with-Rust
cd MCP-Development-with-Rust
# 运行 20 个完整示例中的任何一个
cargo run --bin example_01_hello_world
cargo run --bin example_13_auth_service
cargo run --bin example_20_enterprise_server
# 跟随技术参考指南
open mcp_rust_tutorial.md
选项 3：面向学习的方法
# 从国际教学指南开始
open mcp_rust_tutorial_international.md
# 跟随结构化的学习路径
cargo new mcp_learning_project
cd mcp_learning_project
# 继续阅读国际指南的第二章
📁 项目结构
mcp-rust-tutorial/
├── 📚 学习材料
│ ├── mcp_rust_tutorial.md # 技术参考版本
│ ├── mcp_rust_tutorial_international.md # 国际教学版本
│ └── README.md # 此概述
│
├── 🛠️ 工作示例 (20 个完整项目)
│ ├── src/examples/
│ │ ├── example_01_hello_world.rs # 基本 MCP 服务器
│ │ ├── example_02_calculator.rs # 错误处理模式
│ │ ├── example_05_resource_provider.rs # MCP 资源
│ │ ├── example_09_database.rs # 数据库集成
│ │ ├── example_12_task_queue.rs # 异步编程
│ │ ├── example_13_auth_service.rs # 认证系统
│ │ └── example_20_enterprise_server.rs # 完整的企业应用
│ │
├── ⚙️ 开发工具
│ ├── justfile # 50 多个开发命令
│ ├── .github/workflows/ # 完整的 CI/CD 流水线
│ ├── Cargo.toml # 依赖项和配置
│ └── Cargo.lock # 锁定的依赖项版本
│
└── 📖 文档
├── docs/ # 额外文档
└── examples/ # 使用示例
🌟 关键特性和学习成果
您将掌握的内容
🔧 MCP 协议基础
- 理解工具、资源、提示和采样
- JSON-RPC 通信模式
- 客户端-服务器架构设计
- 协议规范合规性
🦀 高级 Rust 编程
- 所有权、借用和生命周期
- 使用 Result 类型进行错误处理
- 使用 Tokio 进行异步编程
- 泛型编程和特征边界
- 内存安全和性能优化
🏭 生产就绪开发
- 数据库集成（SQLx、迁移、事务）
- 认证和安全性模式
- 监控和可观测性
- 测试策略和 CI/CD
- Docker 部署和扩展
🌍 国际最佳实践
- 全球适用的代码（UTC 时间戳、国际化考虑）
- 清晰的错误消息和文档
- 开发中的文化敏感性
- 易于访问的学习方法
📊 教程比较
| 特征 | 技术参考 | 国际教学 |
|---|---|---|
| 目标受众 | 经验丰富的开发者 | 全球学习者 |
| 语言风格 | 技术性、精确 | 清晰、易于理解 |
| 代码示例 | 20 个完整项目 | 逐步构建 |
| 外部资源 | 130 多个链接 | 精选的全球资源 |
| 学习结构 | 参考导向 | 结构化进展 |
| 时间投入 | 自由进度 | 总计 11 小时 |
| 前提条件 | Rust 知识 | 初学者友好 |
| 使用场景 | 生产实现 | 学习与教育 |
🔧 安装选项
此 crate 提供用于 MCP 开发的教育 Rust 示例：
简单安装：
[dependencies]
mcp_rust_examples = "0.1.0" # 包含所有依赖项的教育示例
全局二进制安装：
# 全局安装所有示例二进制文件
cargo install mcp_rust_examples
# 运行任意示例
example_01_hello_world
example_13_auth_service
example_20_enterprise_server
开发设置：
# 用于开发和扩展示例
git clone https://github.com/RustSandbox/MCP-Development-with-Rust
cd MCP-Development-with-Rust
cargo build --all
# 在本地运行示例
cargo run --bin example_01_hello_world
注意： 若要在自己的项目中完全集成 MCP SDK，请参阅 官方 rmcp 文档。
🛠️ 开发命令
我们提供了一个包含 50 多个命令的综合开发环境，通过 just：
# 快速开发
just run example_01 # 运行特定示例
just test # 运行所有测试
just quality # 代码格式化和检查
# 学习和探索
just demo # 运行所有演示
just docs # 生成文档
just examples # 列出所有可用示例
# 生产准备
just build-release # 优化构建
just security-audit # 安全漏洞扫描
just benchmark # 性能基准测试
🎓 教育理念
Hamze Ghalebi 的教学方法：
凭借超过 20 年向国际受众教授 Rust 的经验，此资源体现了经过验证的教育原则：
- 渐进复杂度：从简单开始，系统地构建
- 实际应用：每个概念都通过真实代码展示
- 文化敏感性：例子和语言适合全球受众
- 行业相关性：在生产环境中使用的模式
- 社区焦点：连接学习者与更广泛的生态系统
国际可访问性：
- 清晰简洁的英语，适合非母语者
- 跨文化的通用示例
- 全球部署和时区考虑
- 多语言资源和社区链接
👨💻 关于作者
Hamze Ghalebi
首席技术官，Remolab
联系方式：
- GitHub: hghalebi
- LinkedIn: Hamze Ghalebi
- X (Twitter): @hamzeml
- 邮件: hamze@remolab.ai
📦 发布与版本
此项目通过 GitHub Actions 自动发布到 crates.io：
自动化发布流程：
- 标记一个版本：
git tag v0.1.0 && git push origin v0.1.0 - GitHub Actions 触发：自动构建和测试
- 多平台二进制文件：为 Linux、macOS、Windows 创建二进制文件
- Crates.io 发布：带有
examples-only功能的发布 - GitHub 发布：创建带有二进制文件和校验和的发布
发布工作流：
- ✅ CI/CD 流水线：完整的测试和构建
- ✅ 跨平台构建：Linux x64、macOS x64/ARM64、Windows x64
- ✅ 自动发布：在标记时发布到 crates.io
- ✅ 二进制分发：所有平台的即用二进制文件
- ✅ 校验和：SHA256 验证以确保安全
版本管理：
# 创建新版本
git tag v0.2.0
git push origin v0.2.0
# 工作流自动执行：
# 1. 构建所有平台的二进制文件
# 2. 发布到 crates.io
# 3. 创建带有资产的 GitHub 发布
# 4. 生成校验和以供验证
Crates.io 徽标：
🤝 贡献
我们欢迎来自全球社区的贡献！此项目得益于各种观点和经验。
如何贡献
对于技术改进：
- 🐛 Bug 修复和性能优化
- 📚 额外的示例和用例
- 🔧 开发工具增强
- 🧪 测试和验证改进
对于教育内容：
- 🌍 翻译和本地化支持
- 📖 额外的学习资源和链接
- 🎯 初学者友好的解释
- 💡 现实世界的用例示例
对于国际可访问性：
- 🗣️ 语言清晰度改进
- 🌐 文化敏感性增强
- 📱 可访问性功能
- 🎨 视觉学习辅助工具
贡献过程
- 分叉 仓库
- 创建 描述性的功能分支
- 遵循 我们的编码标准和文档风格
- 彻底测试 您的更改
- 提交 带有清晰描述的拉取请求
- 建设性地参与 审查反馈
行为准则
我们维护一个欢迎、包容的环境，无论：
- 地理位置或国籍
- 母语或英语熟练程度
- 技术经验水平
- 文化背景
📄 许可
此教育资源在 MIT 许可 下发布，促进全球访问和教育用途。
您可以自由：
- ✅ 在世界各地的教育机构中使用
- ✅ 适应本地学习环境
- ✅ 翻译成其他语言
- ✅ 在商业培训计划中使用
- ✅ 自由分发和分享
我们希望您：
- 📝 维持对原始作者的归属
- 🔄 将改进回馈给社区
- 🌍 尊重国际可访问性重点
- 📚 支持全球学习使命
🔗 外部资源
官方文档
社区和学习
- 码农的 rmcp 指南 - 综合 rmcp 工具包指南
- Rust 学习资源 - 精选的国际资源
- 本周 Rust - 每周社区更新
开发工具
- Rust Playground - 在线 Rust 环境
- Rustlings - 交互式练习
- Exercism Rust 跟踪 - 带导师的练习
📞 支持与联系
学习支持：
🌟 致谢
特别感谢全球 Rust 和 MCP 社区的反馈、贡献和多样化的视角，这些塑造了这一学习资源。此教程之所以存在，是因为世界各地的开发者相信可访问、高质量的教育。
国际贡献者：
- 来自 15 多个国家的审稿人，提供了文化和语言反馈
- 在不同环境中验证示例的 Beta 测试者
- 翻译员和本地化专家
- 在实际课堂环境中测试课程大纲的教育工作者
技术贡献者：
- Rust 核心团队，因其出色的文档和工具
- MCP 规范作者，创造了强大的协议
- 开源库维护者，他们的工作使这些示例成为可能
- CI/CD 和部署专家，增强了我们的开发工作流程
准备好开始学习了吗？ 选择您的路径，开始使用 Rust 构建令人惊叹的 MCP 应用程序！🚀