QMYZ

Provides an MCP server to fetch course lists, retrieve next questions, and submit answers for automated study on the Qing马易战 platform.

python

2

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shibig666-qmyz-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/qmyz-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

The QMYZ MCP Server automates course topic retrieval, question fetching, and automatic answering with immediate feedback, enabling streamlined study automation on the Qing马易战 platform.

How to use

You will interact with the MCP server through a client that supports the MCP protocol. This server exposes three core tools to automate learning tasks: listing courses, fetching the next question for a given course, and submitting an answer to that question. Use these steps in sequence to automatically progress through questions and receive feedback.

Get your available courses by calling the get_courses tool with your session identifier. This returns a mapping of course IDs to course names. 2) For a chosen course, repeatedly request the next question using get_question, analyze the question and options, and decide on the best answer. 3) Submit your chosen answer with submit_question and observe whether you answered correctly. Continue to the next question until you complete the session.

How to install

Prerequisites: Python 3.11 or newer and the uv package manager installed on your system. You will also need the required dependencies: httpx, mcp, pycryptodome.

Step 1: Set up your environment

Step 2: Install dependencies with uv

Step 3: Run the MCP server locally using uv with the specified working directory and entry script

Additional sections

MCP server configuration is designed to be used with an MCP client. The server exposes three distinct tools for programmatic use: get_courses to list available courses, get_question to fetch the next question for a given course, and submit_question to submit an answer for evaluation.

Configuration and integration notes

Security and usage notes: Use your own JSESSIONID securely to access course data. Treat the answers as learning aids and avoid sharing sensitive session details publicly. Ensure you comply with the platform terms of service when using automated tools.

Troubleshooting tips: verify your session ID is valid, ensure the server process started correctly, and check that the MCP client is configured with the correct course IDs and question UUIDs when submitting answers.

Available tools

get_courses

Fetch the list of courses available to the user. Requires a JSESSIONID and returns a dictionary mapping course IDs to course names.

get_question

Retrieve the next question for a specified course. Requires JSESSIONID and course_id; returns the question text, type, options, and a unique UUID.

submit_question

Submit the selected answer for a given question. Requires JSESSIONID, course_id, question UUID, and the chosen answer option (e.g., A, B, C, D).