DevTerminalShopMCP - Terminal Coffee Shop

Terminal.Shop let's you order coffee from the comfort of your terminal using SSH. They also have APIs for the same. This repo creates an MCP server so that these APIs can be used as Tools by an MCP client.

Features

• Browse available coffee products with descriptions and prices
• Manage shipping addresses
• Place an order for your coffee beans

Prerequisites

• Python 3.x
• Terminal Shop Client
• FastMCP Server

Installation

1. Clone the repository:

git clone https://github.com/pramodith/DevTerminalShopMCP.git
cd DevTerminalShopMCP

2. Set up a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install dependencies:

uv sync

Usage

1. Start the MCP server:

python src/mcp_server.py
or
uv --directory PATH_TO_SRC run mcp_server.py

2. The server will guide you through:
   • Browsing available coffee products
   • Entering shipping information
   • Processing payment
   • Confirming your order

Project Structure

• src/
  • mcp_server.py - Main server implementation
  • utils.py - Utility functions for Terminal Shop operations
  • tools/
    • terminal_shop_tools.py - Core shopping functionality

Environment Variables

Create a .env file in the root directory with:

TERMINAL_SHOP_API_KEY=your_api_key

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.