AI导哈

MCP AI代理开发学习平台

Archestra Beginner Goldmine是一个面向初学者的教育网站，帮助开发者从零开始掌握基于MCP的AI代理开发，并提供从基础到生产就绪的完整学习路径。

  • by ParasJagdale
  • HTML
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ParasJagdale/archestra-beginner-goldmine

使用说明

⚡ Archestra初级金矿

使用Archestra掌握基于MCP的AI代理开发的完整指南-从零到生产就绪。

🎯 这是什么？

Archestra初级金矿 是一个以初学者为中心的教育网站，帮助开发人员：

  • ✅ 从头开始理解Archestra和模型上下文协议（MCP）
  • ✅ 构建他们的第一个MCP工具和AI代理
  • ✅ 调试常见设置和运行时错误
  • ✅ 创建生产就绪的MCP项目
  • ✅ 从原型到生产的规模

🌟 为什么这个项目存在

学习Archestra和MCP对初学者来说可能是压倒性的。该资源通过提供以下内容消除了入职摩擦：

  • 清晰、结构化的学习路径 -从基础到高级概念
  • 分步教程 -用工作示例构建真正的MCP工具
  • 故障排除知识库 -常见错误的可搜索解决方案
  • 即用型模板 -复制粘贴MCP服务器和工具代码
  • 最佳实践和项目想法 -构建成功的MCP项目

📚 里面是什么

🏁 入门指南

了解Archestra和MCP是什么，为什么它们很重要，以及如何安装和配置您的第一个代理系统。

🧱 学习路线图

渐进式学习路径，分为三个层次：

  • 第一级： Archestra基础、代理概念、MCP基础
  • 第二级： MCP服务器设置、网关连接、工具创建
  • 第三级： 多工具编排、生产工作流程、可观察性

🧪 分步教程

4个实践教程：

  1. 构建您的第一个MCP工具
  2. 将MCP服务器连接到网关
  3. 将工具附加到AI代理
  4. 调试工具调用失败

🐛 故障排除知识库

8个以上常见问题的可搜索数据库，并提供详细的解决方案：

  • 不支持的MCP方法错误
  • 流传输错误
  • 工具未出现在代理中
  • 网关与注册表混淆
  • JSON-RPC问题
  • /mcp端点错误
  • 接受标头问题
  • SDK与手动MCP的差异

🧰 MCP模板库

准备复制模板：

  • 基本MCP SDK服务器
  • 日志分析工具
  • GitHub自动化工具
  • 松弛警报工具
  • 数据库查询工具

💡 最佳实践和项目创意

  • 成功的发展战略
  • 项目创意（DevOps调试器、报告生成器、随叫随到助手）
  • 需要避免的常见陷阱
  • 演示准备技巧
  • 生产准备检查表

🏗️ 建筑深潜

  • 完整的系统架构
  • 代理工作流程说明
  • 多工具编排模式
  • 生产部署策略
  • 可观察性和监测
  • 扩展策略

🚀 特性

  • ✨ 纯HTML/CSS/JS -无需构建步骤，易于部署
  • 🌙 深色模式 -自动切换主题
  • 🔍 搜索功能 -快速找到解决方案
  • 📱 移动响应 -适用于所有设备
  • 📋 复制到剪贴板 -每个代码块都是可复制的
  • ✅ 进度跟踪 -追踪你的学习历程
  • 🎨 现代设计 -简洁、开发者友好的用户界面

💻 技术栈

  • HTML5 -语义标记
  • TailwindCSS -实用程序优先样式（通过CDN）
  • 普通JavaScript -无需框架
  • 本地存储 -客户端进度跟踪
  • 维塞尔 -部署平台

🏃 快速开始

本地开发

  1. 克隆此存储库：
git clone https://github.com/ParasJagdale/archestra-beginner-goldmine.git
cd archestra-beginner-goldmine
  1. 打开 index.html 在浏览器中：
# Using Python
python -m http.server 8000

# Using Node.js
npx serve

# Or just open the file directly
open index.html
  1. 开始学习！ 🎉

部署到Vercel

  1. 分叉此存储库
  2. 将其导入Vercel
  3. 一键部署-无需配置！

📖 如何使用此资源

适合初学者

  1. 从开始 入门指南
  2. 阅读 MCP基础知识
  3. 跟随 教程1 构建你的第一个工具
  4. 检查 故障排除 当卡住时

面向生产开发人员

  1. 浏览 最佳实践 项目创意
  2. 从以下位置复制模板 模板库
  3. 参考 建筑 用于系统设计
  4. 使用搜索快速找到特定的解决方案

面向生产开发人员

  1. 学习 建筑深潜
  2. 审查生产部署模式
  3. 从示例中实现可观测性
  4. 贡献你自己的学习成果！

🤝 贡献

这是一个 社区驱动的学习中心我们欢迎大家的贡献。

贡献方式

  • 📝 添加教程 -分享你的学习经历
  • 🐛 报告问题 -发现什么问题了吗？请告诉我们
  • 💡 提出改进建议 -更好解释的想法
  • 🧰 共享模板 -贡献您的MCP工具模板
  • 📚 改进文档 -修正拼写错误，澄清概念
  • 🎨 加强设计 -让网站更漂亮

如何做出贡献

  1. 分叉此存储库
  2. 创建要素分支： git checkout -b feature/my-contribution
  3. 进行更改
  4. 本地测试
  5. 承诺： git commit -m "Add: my awesome contribution"
  6. 推： git push origin feature/my-contribution
  7. 打开拉取请求

看 贡献.md 详细指南。

🌍 社区

  • GitHub讨论 -提问，分享项目
  • 问题 -报告错误或请求功能
  • 拉取请求 -直接捐款
  • 推特 -与#ArchestraGoldmine分享您的进展

📊 学习检查表

通过材料跟踪你的进度：

  • []已完成入门
  • []了解MCP生命周期
  • []构建了第一个MCP工具
  • []已连接到网关
  • []代理附带的工具
  • []调试了一个工具故障
  • []已完成所有教程
  • []审查了架构模式
  • []准备生产！

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

  • Archestra团队 -用于构建一个令人惊叹的代理编排平台
  • MCP社区 -用于开发模型上下文协议标准
  • 贡献者 -所有帮助改善此资源的人
  • 你 -与MCP一起学习和建设！

🚀 接下来是什么？

掌握了这里的内容后：

  1. 构建自己的MCP工具
  2. 为Archestra做出贡献
  3. 加入MCP社区讨论
  4. 与他人分享你的知识
  5. 部署到生产环境！ 🚀

建于❤️ 通过Paras Jagdale

⭐ GitHub上的明星 | 🌐 现场演示 | 📖 仓库

相关 MCP