AI导哈

Rust MCP开发学习资源

提供两个完整的教程，帮助开发者从入门到精通使用Rust进行MCP协议开发，适用于不同经验水平的开发者和国际学习者。

  • by RustSandbox
  • Rust
  • 本地部署
  • 21 星标
  • 更新于
在 GitHub 查看 RustSandbox/MCP-Development-with-Rust

使用说明

使用Rust学习MCP开发：完整的学习资源

██████╗ ███████╗███╗   ███╗ ██████╗ ██╗      █████╗ ██████╗ 
██╔══██╗██╔════╝████╗ ████║██╔═══██╗██║     ██╔══██╗██╔══██╗
██████╔╝█████╗  ██╔████╔██║██║   ██║██║     ███████║██████╔╝
██╔══██╗██╔══╝  ██║╚██╔╝██║██║   ██║██║     ██╔══██║██╔══██╗
██║  ██║███████╗██║ ╚═╝ ██║╚██████╔╝███████╗██║  ██║██████╔╝
╚═╝  ╚═╝╚══════╝╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝╚═════╝ 
                                                              
             Advanced Technology Solutions Worldwide

📚 关于此学习资源

这个全面的学习资源提供 两个完整的教程 掌握Rust的模型上下文协议（MCP）开发。从初学者友好的介绍到生产就绪的企业应用程序，这些教程将指导您构建健壮的MCP服务器的各个方面。

发布者： 远程实验室 -先进技术解决方案
作者 哈姆泽·加勒比，CTO

🎯 为什么有两个教程版本？

我们创建了两条不同的学习路径，以服务于不同的受众和学习偏好：

📖 版本1：技术参考指南

文件： mcp_rust_tutorial.md

非常适合：

  • 寻求全面技术文档的经验丰富的开发人员
  • 在生产环境中实施MCP的团队
  • 喜欢详细代码示例和API参考的开发人员

主要特点：

  • ✅ 20个完整的工作示例 -从Hello World到企业系统
  • ✅ 3000多行生产代码 -真实、经过测试的实现
  • ✅ 全面的Rust概念 -高级模式和最佳实践
  • ✅ 外部学习资源 -130+精选链接和参考
  • ✅ 生产部署 -CI/CD、Docker、监控和扩展
  • ✅ 行业最佳实践 -安全性、性能和可维护性

示例项目包括：

  • 基本MCP服务器（Hello World、计算器、文本处理器）
  • 真实世界的应用程序（数据库集成、文件操作、WebSocket服务器）
  • 高级系统（任务队列、身份验证、通知服务）
  • 企业解决方案（搜索引擎、区块链集成、机器学习模型服务器）

🌍 第二版：国际教学指南

文件： mcp_rust_tutorial_international.md

非常适合：

  • 国际学习者和非英语母语者
  • Rust或MCP开发新手
  • 寻求结构化、循序渐进学习的学生
  • 教授Rust和MCP概念的教育工作者

主要特点：

  • ✅ 清晰国际英语 -面向全球学习者
  • ✅ 结构化学习路径 -按技能水平和时间投入进行组织
  • ✅ 教学法 -应用了20年的教育经验
  • ✅ 分步说明 -对每个概念的详细解释
  • ✅ 文化敏感性 -适合全球受众的示例和语言
  • ✅ 视觉学习辅助工具 -表情符号、图表和进度跟踪

学习之旅：

📚 Foundation (30 minutes)    → Core concepts and setup
🏗️  Basic Practice (2 hours)   → First working MCP server
⚙️  Intermediate (3 hours)     → Real-world applications
🚀 Advanced (4 hours)         → Production-grade systems
🌍 Deployment (1 hour)        → Global deployment strategies

🚀 入门指南

先决条件

  • 锈蚀1.70+ 已安装(安装指南)
  • 基本终端/命令行 知识
  • 文本编辑器或IDE （建议使用锈蚀分析仪的VS代码）

快速入门（选择您的路径）

选项1：从crates.io安装（推荐）

# Add as dependency in your Cargo.toml
[dependencies]
mcp_rust_examples = "0.1.0"

# Or install binaries globally
cargo install mcp_rust_examples

# Run examples directly
example_01_hello_world
example_02_calculator

选项2：克隆和构建（开发）

# Clone the repository
git clone https://github.com/RustSandbox/MCP-Development-with-Rust
cd MCP-Development-with-Rust

# Run any of the 20 working examples
cargo run --bin example_01_hello_world
cargo run --bin example_13_auth_service
cargo run --bin example_20_enterprise_server

# Follow the technical reference guide
open mcp_rust_tutorial.md

选项3：以学习为导向的方法

# Start with the international teaching guide
open mcp_rust_tutorial_international.md

# Follow the structured learning path
cargo new mcp_learning_project
cd mcp_learning_project
# Continue with Chapter 2 of the international guide

📁 项目结构

mcp-rust-tutorial/
├── 📚 Learning Materials
│   ├── mcp_rust_tutorial.md              # Technical Reference Version
│   ├── mcp_rust_tutorial_international.md # International Teaching Version
│   └── README.md                          # This overview
│
├── 🛠️ Working Examples (20 Complete Projects)
│   ├── src/examples/
│   │   ├── example_01_hello_world.rs     # Basic MCP server
│   │   ├── example_02_calculator.rs      # Error handling patterns
│   │   ├── example_05_resource_provider.rs # MCP resources
│   │   ├── example_09_database.rs        # Database integration
│   │   ├── example_12_task_queue.rs      # Async programming
│   │   ├── example_13_auth_service.rs    # Authentication systems
│   │   └── example_20_enterprise_server.rs # Complete enterprise app
│   │
├── ⚙️ Development Tools
│   ├── justfile                          # 50+ development commands
│   ├── .github/workflows/                # Complete CI/CD pipeline
│   ├── Cargo.toml                        # Dependencies and configuration
│   └── Cargo.lock                        # Locked dependency versions
│
└── 📖 Documentation
    ├── docs/                             # Additional documentation
    └── examples/                         # Usage examples

🌟 主要特征和学习成果

你将掌握什么

🔧 MCP协议基础

  • 了解工具、资源、提示和采样
  • JSON-RPC通信模式
  • 客户端-服务器架构设计
  • 协议规范合规性

🦀 高级Rust编程

  • 所有权、借款和寿命
  • 结果类型的错误处理
  • 与Tokio异步编程
  • 泛型编程和特征边界
  • 内存安全和性能优化

🏭 生产就绪开发

  • 数据库集成（SQLx、迁移、事务）
  • 身份验证和安全模式
  • 监控和可观察性
  • 测试策略和CI/CD
  • Docker部署和扩展

🌍 国际最佳实践

  • 全局工作的代码（UTC时间戳、i18n考虑因素）
  • 清除错误消息和文档
  • 发展中的文化敏感性
  • 无障碍学习方法

📊 教程比较

特色 技术参考 国际教学
目标受众 经验丰富的开发人员 全球学习者
语言风格 技术性、精确性 清晰、可访问
代码示例 20个完整项目 逐步构建
外部资源 130+链接 精选全球资源
学习结构 基于参考 结构化进展
投资 自定进度 共11小时
先决条件 Rust知识 初学者友好
用例 生产实施 学习与教育

🔧 安装选项

此板条箱为MCP开发提供了具有教育意义的Rust示例：

安装简单：

[dependencies]
mcp_rust_examples = "0.1.0"  # Educational examples with all dependencies

全局二进制安装：

# Install all example binaries globally
cargo install mcp_rust_examples

# Run any example
example_01_hello_world
example_13_auth_service
example_20_enterprise_server

开发设置：

# For development and extending examples
git clone https://github.com/RustSandbox/MCP-Development-with-Rust
cd MCP-Development-with-Rust
cargo build --all

# Run examples locally
cargo run --bin example_01_hello_world

注： 有关您自己项目中完整的MCP SDK集成，请参阅 官方rmcp文件.

🛠️ 开发命令

我们通过以下方式提供了一个包含50多个命令的全面开发环境 仅仅:

# Quick development
just run example_01              # Run specific example
just test                        # Run all tests
just quality                     # Code formatting and linting

# Learning and exploration
just demo                        # Run all demos
just docs                        # Generate documentation
just examples                    # List all available examples

# Production readiness
just build-release               # Optimized builds
just security-audit              # Security vulnerability scan
just benchmark                   # Performance benchmarking

🎓 教育哲学

Hamze Ghalebi的教学方法：

凭借20多年向国际受众教授Rust的经验，该资源体现了经过验证的教育原则：

  • 渐进复杂性：从简单开始，系统构建
  • 实际应用：每个概念都用实际代码演示
  • 文化敏感性：全球可访问的示例和语言
  • 行业相关性：生产环境中使用的模式
  • 社区焦点：将学习者与更广泛的生态系统联系起来

国际无障碍：

  • 清晰简洁的英语，适合非母语人士
  • 跨文化翻译的通用示例
  • 全球部署和时区考虑因素
  • 多语言资源和社区的链接

👨‍💻 关于作者

哈姆泽·加勒比
Remolab首席技术官

连接：

📦 出版与发布

该项目通过GitHub Actions使用自动发布到crates.io：

自动发布流程：

  1. 标记释放: git tag v0.1.0 && git push origin v0.1.0
  2. GitHub操作触发器：自动构建和测试
  3. 多平台二进制文件：为Linux、macOS、Windows创建二进制文件
  4. Crates.io出版：发布到crates.io examples-only 特征
  5. GitHub发布：使用二进制文件和校验和创建版本

发布工作流程：

  • ✅ CI/CD管道：全面测试和构建
  • ✅ 跨平台构建：Linux x64、macOS x64/ARM64、Windows x64
  • ✅ 自动发布：在标签上发布到crates.io
  • ✅ 二进制发布：适用于所有平台的现成二进制文件
  • ✅ 校验和：SHA256安全验证

版本管理：

# Create a new release
git tag v0.2.0
git push origin v0.2.0

# The workflow automatically:
# 1. Builds binaries for all platforms
# 2. Publishes to crates.io
# 3. Creates GitHub release with assets
# 4. Generates checksums for verification

Crates.io徽章：

🤝 贡献

我们欢迎国际社会的贡献！这个项目依靠不同的观点和经验而蓬勃发展。

如何做出贡献

技术改进：

  • 🐛 Bug修复和性能优化
  • 📚 其他示例和用例
  • 🔧 开发工具增强
  • 🧪 测试和验证改进

教育内容：

  • 🌍 翻译和本地化支持
  • 📖 其他学习资源和链接
  • 🎯 初学者友好的解释
  • 💡 真实世界的用例示例

国际无障碍：

  • 🗣️ 提高语言清晰度
  • 🌐 增强文化敏感性
  • 📱 辅助功能
  • 🎨 视觉学习辅助工具

贡献过程

  1. 分叉 存储库
  2. 创建 具有描述性名称的特征分支
  3. 跟随 我们的编码标准和文档风格
  4. 测试 你的改变彻底
  5. 提交 具有明确描述的拉取请求
  6. 参与 建设性地提供审查反馈

行为准则

我们为所有贡献者营造了一个热情、包容的环境，无论：

  • 地理位置或国籍
  • 母语或英语熟练程度
  • 技术经验水平
  • 文化背景

📄 许可证

该教育资源根据 MIT许可证促进全球无障碍和教育使用。

您可以自由地：

  • ✅ 在世界各地的教育机构中使用
  • ✅ 适应当地学习环境
  • ✅ 翻译成其他语言
  • ✅ 在商业培训项目中使用
  • ✅ 自由分发和分享

我们恳请您：

  • 📝 保持对原作者的归属
  • 🔄 为社区做出贡献
  • 🌍 尊重国际无障碍重点
  • 📚 支持全球学习任务

🔗 外部资源

官方文件

社区与学习

开发工具

📞 支持与联系

学习支持：

🌟 致谢

特别感谢全球Rust和MCP社区，他们的反馈、贡献和不同的观点塑造了这个学习资源。本教程的存在是因为全球开发人员的协作精神，他们相信无障碍、高质量的教育。

国际贡献者：

  • 来自15个以上国家的审稿人提供了文化和语言反馈
  • 在不同环境中验证示例的Beta测试人员
  • 翻译和本地化专家
  • 在真实课堂环境中测试课程的教育工作者

技术贡献者：

  • Rust核心团队的优秀文档和工具
  • 创建健壮协议的MCP规范作者
  • 开源库维护者，他们的工作使这些示例成为可能
  • CI/CD和部署专家增强了我们的开发工作流程

准备好开始学习了吗？ 选择你的道路，开始用Rust构建令人惊叹的MCP应用程序！ 🚀

从技术参考开始→
从国际指南开始→

相关 MCP