Content
<div>
<h1 align="center"><a href="https://www.epicai.pro/">MCP Fundamentals 🧱</a></h1>
<strong>
Meet users in the AI apps they already use
</strong>
<p>
Your users are increasingly getting accustomed to using natural language to communicate with AI apps like ChatGPT, Claude Desktop, and Cursor. With MCP,
you can build AI-powered apps that integrate with these apps, allowing you
to meet users where they are.
</p>
</div>
<hr />
<div align="center">
<a
alt="Epic Web logo with the words Deployed Version"
href="https://mcp-fundamentals.epicai.pro/"
>
<img
width="300px"
src="https://github-production-user-asset-6210df.s3.amazonaws.com/1500684/254000390-447a3559-e7b9-4918-947a-1b326d239771.png"
/>
</a>
</div>
<hr />
<!-- prettier-ignore-start -->
[![Build Status][build-badge]][build]
[![GPL 3.0 License][license-badge]][license]
[![Code of Conduct][coc-badge]][coc]
<!-- prettier-ignore-end -->
## 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](https://www.epicai.pro/letting-ai-interface-with-your-app-with-mcps-talk)
- [MCP Introduction](https://modelcontextprotocol.io/introduction)
- [Your AI Assistant Instructor: The EpicShop MCP Server](https://www.epicai.pro/your-ai-assistant-instructor-the-epicshop-mcp-server-0eazr)
- [How to Debug Your MCP Server](https://www.epicai.pro/how-to-debug-your-mcp-server-38qyl)
- [MCP Tool Design: From APIs to AI-First Interfaces](https://useai.substack.com/p/mcp-tool-design-from-apis-to-ai-first)
## 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:
```shell
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:
```sh nonumber
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`](http://localhost:5639/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
[Epic Web Getting Started Guide](https://www.epicweb.dev/get-started).
[](https://www.epicweb.dev/get-started)
<!-- prettier-ignore-start -->
[npm]: https://www.npmjs.com/
[node]: https://nodejs.org
[git]: https://git-scm.com/
[build-badge]: https://img.shields.io/github/actions/workflow/status/epicweb-dev/mcp-fundamentals/validate.yml?branch=main&logo=github&style=flat-square
[build]: https://github.com/epicweb-dev/mcp-fundamentals/actions?query=workflow%3Avalidate
[license-badge]: https://img.shields.io/badge/license-GPL%203.0%20License-blue.svg?style=flat-square
[license]: https://github.com/epicweb-dev/mcp-fundamentals/blob/main/LICENSE
[coc-badge]: https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=flat-square
[coc]: https://kentcdodds.com/conduct
[win-path]: https://www.howtogeek.com/118594/how-to-edit-your-system-path-for-easy-command-line-access/
[mac-path]: http://stackoverflow.com/a/24322978/971592
[issue]: https://github.com/epicweb-dev/mcp-fundamentals/issues/new
<!-- prettier-ignore-end -->
Connection Info
You Might Also Like
awesome-mcp-servers
A collection of MCP servers.
Git
A Model Context Protocol server for Git automation and interaction.
Appwrite
Build like a team of hundreds
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.
chatbox
User-friendly Desktop Client App for AI Models/LLMs (GPT, Claude, Gemini, Ollama...)
Continue
Continue is an open-source project for seamless server management.