Guitar Store MCP Server

A Model Context Protocol (MCP) server for a guitar store that provides tools for querying guitar inventory and processing orders.

Features

- Get all guitars in inventory
- Filter guitars by type (Electric or Acoustic)
- Filter guitars by brand
- Get guitar details by ID
- Process guitar purchases
- View all orders
- Get inventory status summary

Setup

1. Install dependencies:

npm install

2. Start the server:

npm start

The server will run on http://localhost:3001 by default.

Endpoints

- SSE Endpoint: http://localhost:3001/sse
- Messages Endpoint: http://localhost:3001/messages

Available MCP Tools

1. getGuitars - Get all guitars in inventory
2. getGuitarsByType - Get guitars by type (Electric or Acoustic)
3. getGuitarsByBrand - Get guitars by brand
4. getGuitarById - Get a specific guitar by ID
5. getOrders - Get all guitar orders
6. purchaseGuitars - Purchase one or more guitars
7. getInventoryStatus - Get inventory status summary

Example Usage

To interact with this MCP server, you'll need an MCP client. The server uses Server-Sent Events (SSE) for communication.

Building a Frontend

You can build a frontend for this MCP server using any web framework. The frontend should connect to the SSE endpoint and send messages to the messages endpoint.