https://github.com/thomascode92/dyi-mcp-server

An MCP STDIO server build from scratch to understand how the the Model Context Protocol actually functions
https://github.com/thomascode92/dyi-mcp-server

Last synced: 4 months ago
JSON representation

An MCP STDIO server build from scratch to understand how the the Model Context Protocol actually functions

• Host: GitHub
• URL: https://github.com/thomascode92/dyi-mcp-server
• Owner: ThomasCode92
• Created: 2025-08-05T18:01:28.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-08-11T19:15:16.000Z (10 months ago)
• Last Synced: 2025-08-11T21:12:38.946Z (10 months ago)
• Size: 8.79 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# DYI MCP Server

The project demonstrates how to create a custom MCP server and client from the

ground up without relying on third-party libraries. It also illustrates how to

integrate this client with an AI agent.

> This project is based on a couple of YouTube videos by Jack Herrington:

>

> - [Build a Custom MCP Server in 15 Minutes](https://www.youtube.com/watch?v=nTMSyldeVSw)

> - [MCP Client Setup in 10 Minutes](https://www.youtube.com/watch?v=S2x1bsMk19I)

> - [AI Tool Calling](https://www.youtube.com/watch?v=PD2ecDWbeNk)

## ☕ About This MCP Server

This MCP server implements a **coffee shop** interface that allows AI agents to:

- Browse available coffee drinks (Latte, Mocha, Flat White)

- Get detailed information about each drink including prices and descriptions

The coffee shop MCP provides a practical example of building custom MCP tools

that integrate with AI agents for real-world applications.

![Chat with AI](./images/chat_with_ai.png)

## 🛠️ Core Technologies

- [Node.js](https://nodejs.org/) - JavaScript runtime.

- [TypeScript](https://www.typescriptlang.org/) - A superset of JavaScript that

  adds static types.

- [Model Context Protocol](https://modelcontextprotocol.io/) - The protocol for

  building AI applications.

## 📚 Additional Resources

For detailed instructions on interacting with each component:

- **[MCP Server README](./apps/server/README.md)** - Learn how to run and

  configure the MCP server, use the inspector interface, and connect external

  clients.

- **[MCP Client README](./apps/client/README.md)** - Discover how to set up AI

  agent connections, run the client, and use the interactive terminal interface.