For Five Coffee MCP Server

A Model Context Protocol (MCP) server that provides access to For Five Coffee menu data. Works with Claude Desktop, Cursor, and other MCP clients, plus provides a REST API.

Quick Start

git clone <this-repo>
cd menu-mcp
npm install
npm start

This starts both:

• MCP Server (stdio) - for AI assistants
• HTTP API (port 3000) - for web apps

MCP Client Setup

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "for-five-coffee": {
      "command": "node",
      "args": ["/path/to/menu-mcp/server.js"]
    }
  }
}

Cursor

Option 1: Let Cursor start the server Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "for-five-coffee": {
      "command": "node",
      "args": ["/Users/marco/git/menu-mcp/server.js"],
      "env": {
        "PORT": "3000"
      }
    }
  }
}

Option 2: Connect to already running server If you're running npm start separately, add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "for-five-coffee": {
      "url": "http://localhost:3000/sse"
    }
  }
}

This connects Cursor to the running MCP server via Server-Sent Events (SSE).

Usage Examples

Ask Your AI Assistant

• "What coffee drinks does For Five Coffee have?"
• "Search for pastries on the menu"
• "What's the cheapest coffee option?"
• "Show me all tea varieties"

Use the HTTP API

# Get full menu
curl http://localhost:3000/api/menu

# Search for items
curl "http://localhost:3000/api/menu/search?q=latte"

# Get categories
curl http://localhost:3000/api/menu/categories

In Your Code

// Fetch menu data
const response = await fetch('http://localhost:3000/api/menu');
const menu = await response.json();

// Search items
const search = await fetch('http://localhost:3000/api/menu/search?q=coffee');
const results = await search.json();

import requests

# Get menu
menu = requests.get('http://localhost:3000/api/menu').json()

# Search
results = requests.get('http://localhost:3000/api/menu/search', 
                      params={'q': 'latte'}).json()

Available Endpoints

Endpoint	Description
GET /	Server info
GET /health	Health check
GET /api/menu	Full menu
GET /api/menu/search?q={query}	Search items
GET /api/menu/categories	All categories
GET /api/menu/category/{name}	Items by category

MCP Tools

• get_full_menu - Get complete menu
• search_menu_items - Search by query
• get_menu_categories - List categories
• get_items_by_category - Filter by category

Development

npm run dev          # Start with auto-restart
npm test             # Run all tests
npm run test:unit    # Unit tests only
npm run test:http    # HTTP API tests only  
npm run test:sse     # SSE MCP transport tests only
npm run test:integration # Integration tests only
npm run lint         # Check code style

Troubleshooting

MCP not working?

• Check the absolute path to server.js in your config
• Restart your MCP client after config changes
• Run npm start manually to test

HTTP API not responding?

• Make sure server is running: npm start
• Check port 3000 isn't in use: lsof -i :3000
• Test: curl http://localhost:3000/health

No menu data?

• Check internet connection
• The server handles SSL issues automatically
• Website structure may have changed (fallbacks included)

License

Apache 2.0