Pierre Tutorial

Pierre MCP服务器教程

在Rust中构建生产级MCP（模型上下文协议）服务器的综合教程。

在线阅读

在线阅读教程

关于本教程

本教程记录了 皮埃尔健身智能 MCP服务器。它包括：

第一部分：基础

• 项目架构和模块组织
• 类型安全错误处理 thiserror
• 配置管理和环境变量
• 具有存储库模式的数据库架构

第二部分：安全与环境

• 依赖注入模式
• 加密密钥管理（MEK+DEK）
• RS256 JWT认证
• 多租户数据库隔离
• 中间件和请求上下文

第三部分：议定书

• JSON-RPC 2.0基础
• MCP请求流和工具调度
• 传输层（HTTP、WebSocket、SSE、stdio）
• 工具注册表和模式生成
• SDK网桥架构
• TypeScript类型生成

第四部分：OAuth和提供者

• OAuth 2.0授权服务器（RFC 6749、RFC 7636）
• 面向健身提供商的OAuth 2.0客户端
• 可插拔的提供者架构
• A2A（代理对代理）协议

第五部分：领域情报

• 47个用于适应性分析的MCP工具
• 运动科学算法（TSS、VDOT、FTP）
• 恢复和睡眠分析
• 与美国农业部整合的营养跟踪

第六部分：操作

• 异步Rust的测试模式
• 设计系统和前端
• 部署策略
• 性能优化

在当地建设

本教程使用 mdBook.要在本地构建：

# Install mdBook
cargo install mdbook

# Build the book
mdbook build

# Serve locally with hot reload
mdbook serve --open

贡献

欢迎投稿！拜托：

1. 保持代码示例准确和最新
2. 遵循现有章节格式
3. 包括学习目标和练习
4. 在提交之前测试任何代码示例

许可证

本教程在MIT或Apache 2.0下具有双重许可，与Pierre MCP Server许可证相匹配。

______________________________________________________________________

*部分 皮埃尔健身智能 项目。*