Skip to content

NicolasDangg/ielts-dictionary

Repository files navigation

All-in-One MCP

This project is an all-in-one MCP (Multi-purpose chatbot) that provides access to a variety of tools, including a dictionary, game deals, and a free games finder.

Features

  • Dictionary: Get definitions of English words using the Merriam-Webster Collegiate Dictionary.
  • Game Deals: Find the latest game deals under $10 from popular stores.
  • Free Games: Discover free-to-play games sorted by name and platform.

Built With

  • FastMCP - A framework for building multi-purpose chatbots.

Getting Started

To get started, you'll need to have Python 3 installed on your system. You'll also need to get an API key from Merriam-Webster.

Prerequisites

  • Python 3.10 or higher
  • Pip

Installation

  1. Clone the repo:
    git clone https://github.com/NicolasDangg/ielts-dictionary.git
  2. Install the required packages:
    pip install -r requirements.txt
  3. Create a .env file in the root directory and add your Merriam-Webster API key:
    MERRIAM_API="your-api-key"
    

Obtaining a Merriam-Webster API Key

  1. Go to the Merriam-Webster Developer Center and sign up for a free account.
  2. Once you're logged in, you'll find your API key under the "My Keys" section.
  3. Copy the key and paste it into your .env file.

Usage

To start the MCP, run the following command in the root directory:

python main.py

This will start the FastMCP server, and you can now access the tools through the provided interface.

API Attribution

The getDeals and freeGames functions are powered by the CheapShark API.

About

An MCP created for IELTS students/learners, aims to provide an easy to access to definitions of words through Merriam-Webster official Collegiate Dictionary or Learners Dictionary.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages