MCPcopy Index your code
hub / github.com/epicweb-dev/mcp-fundamentals

github.com/epicweb-dev/mcp-fundamentals @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
759 symbols 2,577 edges 218 files 2 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

MCP Fundamentals 🧱

Meet users in the AI apps they already use

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.

<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"
/>


Build Status GPL 3.0 License Code of Conduct

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:

System Requirements

  • git v2.18 or greater
  • NodeJS v22.13.0 or greater
  • 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 or mac/linux.

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
  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 with as many details as you can offer.

The Workshop App

Learn all about the workshop app on the Epic Web Getting Started Guide.

Kent with the workshop app in the background

Core symbols most depended-on inside this repo

sql
called by 23
exercises/05.prompts/02.problem.optimized-prompt/src/db/utils.ts
sql
called by 23
exercises/05.prompts/01.problem.prompts/src/db/utils.ts
sql
called by 23
exercises/05.prompts/01.solution.prompts/src/db/utils.ts
sql
called by 23
exercises/05.prompts/02.solution.optimized-prompt/src/db/utils.ts
sql
called by 23
exercises/05.prompts/03.solution.completion/src/db/utils.ts
sql
called by 23
exercises/05.prompts/03.problem.completion/src/db/utils.ts
sql
called by 23
exercises/03.resources/04.solution.completion/src/db/utils.ts
sql
called by 23
exercises/03.resources/01.solution.simple/src/db/utils.ts

Shape

Method 378
Function 309
Class 72

Languages

TypeScript100%

Modules by API surface

exercises/05.prompts/03.solution.completion/src/db/index.ts21 symbols
exercises/05.prompts/03.problem.completion/src/db/index.ts21 symbols
exercises/05.prompts/02.solution.optimized-prompt/src/db/index.ts21 symbols
exercises/05.prompts/02.problem.optimized-prompt/src/db/index.ts21 symbols
exercises/05.prompts/01.solution.prompts/src/db/index.ts21 symbols
exercises/05.prompts/01.problem.prompts/src/db/index.ts21 symbols
exercises/04.resource-tools/02.solution.linked/src/db/index.ts21 symbols
exercises/04.resource-tools/02.problem.linked/src/db/index.ts21 symbols
exercises/04.resource-tools/01.solution.embedded/src/db/index.ts21 symbols
exercises/04.resource-tools/01.problem.embedded/src/db/index.ts21 symbols
exercises/03.resources/04.solution.completion/src/db/index.ts21 symbols
exercises/03.resources/04.problem.completion/src/db/index.ts21 symbols

For agents

$ claude mcp add mcp-fundamentals \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact