diy-mcp

mwpryer/diy-mcp

3.2

If you are the rightful owner of diy-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This document provides a structured overview of a DIY Model Context Protocol (MCP) server implementation for managing a Chinese tea collection.

Tools

  1. getTeasByType

    Get all teas of a specific type

  2. getTeasByRegion

    Get all teas from a specific province or region

DIY MCP

A simple from-scratch implementation of the Model Context Protocol (MCP) for building MCP servers and clients using stdio. This example uses a simple Chinese tea collection with descriptions, origins, etc.

For production applications, check out the official MCP SDKs.

Project Structure

mcp/
ā”œā”€ā”€ server/           # MCP server for Chinese tea information
ā”‚   ā””ā”€ā”€ src/
ā”‚       ā”œā”€ā”€ index.ts
ā”‚       ā”œā”€ā”€ stdio.ts
ā”‚       ā””ā”€ā”€ teas.json
ā””ā”€ā”€ client/           # MCP client CLI with Claude as LLM
    ā””ā”€ā”€ src/
        ā”œā”€ā”€ index.ts
        ā””ā”€ā”€ llm.ts

MCP Server

The core of this implementation is a lightweight MCP server. It offers the following resources and tools:

  • Resources:
    • tea://teas: List of all available teas
    • tea://teas/{slug}: Details of a specific tea
  • Tools:
    • getTeasByType: Get all teas of a specific type
    • getTeasByRegion: Get all teas from a specific province or region

Setup

cd server
npm install
npm run build

Running

You can test the MCP server with MCP Inspector, an interactive tool for testing and debugging MCP servers.

cd server
npm run inspector

MCP Client

You can interact with the MCP server through an MCP client like Claude Desktop, alternatively, you can use the included DIY MCP client. By adding your Anthropic API key, you can have Claude intelligently determine which tools to use based on your prompt.

The client provides three interaction modes:

  • Ask LLM: Let Claude interact with the MCP server
  • Get a resource: Directly access MCP server resources
  • Use a tool: Directly call MCP server tools

Setup

cd client
npm install

To use Claude, first copy the example environment file and add your Anthropic API key with available credits to the ANTHROPIC_API_KEY variable:

cp .env.example .env

Running

The client will automatically start the MCP server, so ensure you've built it first.

cd server
npm run build

cd client
npm start

Usage

Once running, you can interact with the MCP server through the MCP client CLI. Try asking the LLM some questions about Chinese tea:

  1. "What teas do you know about?"
  2. "Which teas come from Fujian?"
  3. "What is your favorite green tea?"

Resources