ai-to-the-world-mcp-workshop

# 🌐 AI 走向世界：MCP Workshop ## 欢迎来到AI to the World MCP工作坊！ 模型上下文协议（Model Context Protocol，MCP）是一个开放标准，允许AI助手使用外部工具并访问实时信息。通过构建MCP服务器，您可以使像Claude这样的AI系统通过您的自定义工具扩展其功能，从而创建更强大的AI代理。 在本次工作坊中，我们将构建和部署一个带有实用工具的MCP服务器。您可以通过在此代码库中切换分支来逐步完成每个步骤。 ## 前提条件 在开始本次研讨会之前，请确保您已安装以下内容： - **Node.js**（版本 18 或更高） - [下载](https://nodejs.org/) - **Wrangler CLI** - 使用 `npm install -g wrangler` 安装 - **Cloudflare 账户** - [注册](https://dash.cloudflare.com/sign-up)（免费套餐即可） - **Git** - [下载](https://git-scm.com/downloads) 您还需要一个您选择的文本编辑器或 IDE（推荐使用 VS Code）。 **可选：** - **Claude Desktop** - [下载](https://claude.ai/desktop) - 仅在第 4 步的可选集成中需要。研讨会可以仅使用 Cloudflare AI Playground 完成。 ## 开始使用 本次研讨会旨在通过自己实现代码逐步进行。每个步骤在本仓库的独立分支中都有文档记录以供参考。 1. **按顺序执行步骤**，从步骤 1 开始。 2. **如果遇到困难，可以使用本仓库作为参考**： - 浏览 GitHub 上对应步骤的分支以查看实现 - 步骤分支命名为 `step1`、`step2` 等 - 查看每个分支中的 README.md 以获取详细说明 - 检查每个分支中的代码以查看完整实现 3. **如果在现场研讨会中落后**，可以使用讲师的代码作为检查点。 每个步骤都包含详细的故障排除部分，以帮助您克服常见问题。 ## 工作坊步骤 ### 第一步：开始使用 MCP Server 了解 MCP 的基本知识，以及 AI 助手如何使用外部工具来增强其功能。 ### 步骤 2：添加自定义工具 了解如何通过创建自己的自定义工具来扩展 AI 能力，以解决特定问题。我们将创建一个 randomNumber 工具，AI 助手可以在游戏、模拟和不可预测的结果中使用。 ### 步骤 3：使用 Cloudflare drand 增强随机数 与外部 API 集成，使 AI 助手能够访问超出其训练数据的强大服务。 ### 步骤 4：在 Cloudflare AI Playground 上部署和使用 通过将工具部署到云端并连接到真实的 AI 助手，使您的工具在任何地方都可访问。我们将使用 Cloudflare AI Playground 进行测试，并提供关于 Claude Desktop 集成的可选部分。 ### 步骤 5：设置 Cloudflare KV 存储 了解如何使用 Cloudflare KV 为您的 MCP 服务器添加持久存储。我们将设置状态应用所需的基础设施。 ### 步骤 6：构建一个持久化的待办事项应用 构建一个完整的待办事项列表应用，该应用能够在对话之间保持状态，使 AI 助手能够记住用户的任务。 ### 步骤 7：使用 AI 助手自定义您的 MCP Server 使用像 Claude Code 或 Cursor 这样的 AI 工具创建您自己的自定义 MCP 工具，连接到您感兴趣的 API 和服务。此步骤鼓励创造性探索，并展示了 AI 如何加速您的开发工作流程。 ## 其他资源 - [模型上下文协议 (MCP) 文档](https://modelcontextprotocol.io/) - [Cloudflare Workers 文档](https://developers.cloudflare.com/workers/) - [Cloudflare KV 文档](https://developers.cloudflare.com/workers/runtime-apis/kv/) - [Cloudflare AI Playground](https://playground.ai.cloudflare.com/) - [Claude 文档](https://docs.anthropic.com/claude/) ## 社区与支持 我们很想听听您所构建的内容或帮助解答任何问题！ - **Discord**: 加入 [Cloudflare Developers Discord](https://discord.com/invite/cloudflaredev) - **论坛**: 在 [Cloudflare Community Forums](https://community.cloudflare.com/) 发帖 - **GitHub**: 在 [Cloudflare AI GitHub](https://github.com/cloudflare/ai) 报告问题或贡献代码 - **Twitter**: 关注 [@CloudflareDev](https://twitter.com/CloudflareDev) 获取更新