epicweb-dev/mcp-fundamentals

Основы 🧱 MCP

Познакомьтесь с пользователями в приложениях ИИ, которыми они уже пользуются

Ваши пользователи всё чаще привыкают использовать естественный язык для общения с ИИ-приложениями, такими как ChatGPT, Claude Desktop и Cursor. С MCP, вы можете создавать приложения на базе ИИ, которые интегрируются с этими приложениями, позволяя вам Встречать пользователей там, где они находятся.

Предварительные требования

• Опыт работы с JavaScript/TypeScript
• Node.js опыт

Ресурсы до семинара

Вот несколько ресурсов, которые вы можете прочитать до того, как пройти мастер-класс, чтобы помочь себе начать Скорость по некоторым инструментам и концепциям, которые мы будем рассматривать:

• Возможность ИИ взаимодействовать с вашим приложением с помощью MCP
• Введение в MCP
• Ваш ассистент-инструктор по ИИ: сервер EpicShop MCP
• Как отладить ваш MCP-сервер
• Проектирование инструментов MCP: от API до интерфейсов, ориентированных на искусственный интеллект

Требования к системе

• [git][git] v2.18 или выше
• [NodeJS][node] версии 22.13.0 или выше
• [npm][npm] v8.16.0 или выше

Все они должны быть доступны в вашем PATH. Для проверки всё настроено Правильно, вы можете запустить следующее:

Если у вас возникают трудности с чем-то из этого, узнайте больше о среде PATH переменной и как это исправить здесь для [windows][win-path] или [mac/linux] [mac-path].

[![Build Status][build-badge]][build] [![GPL 3.0 License][license-badge]][license] [![Code of Conduct][coc-badge]][coc]

Prerequisites

• JavaScript/TypeScript experience
• Node.js experience

Pre-workshop Resources

Here are some resources you can read before taking the workshop to get you up to speed on some of the tools and concepts we’ll be covering:

• Letting AI Interface with Your App with MCPs
• MCP Introduction
• Your AI Assistant Instructor: The EpicShop MCP Server
• How to Debug Your MCP Server
• MCP Tool Design: From APIs to AI-First Interfaces

System Requirements

• [git][git] v2.18 or greater
• [NodeJS][node] v22.13.0 or greater
• [npm][npm] v8.16.0 or greater

All of these must be available in your PATH. To verify things are set up properly, you can run this:

git --version
node --version
npm --version

If you have trouble with any of these, learn more about the PATH environment variable and how to fix it here for [windows][win-path] or [mac/linux][mac-path].

Setup

Use the Epic Workshop CLI to get this setup:

npx --yes epicshop@latest add mcp-fundamentals

To make sure your environment is running correctly, please follow these additional steps:

1. Run the workshop app with npm start
2. Open the last exercise solution at /exercise/05/02/solution?preview=solution
3. Click the “Start App” button
4. Click the “Connect” button

You’ll know it’s working if you see a green dot and the word “Connected” in the MCP Inspector app.

If you experience errors during this setup process, please open [an issue][issue] with as many details as you can offer.

The Workshop App

Learn all about the workshop app on the