Skip to main content

Configuration

The server is designed to need no configuration: no API keys, no environment variables, no network access and no files on disk. This page lists everything you can control and every built-in limit.

Starting the server​

CommandWhen to use it
edumaths360-mcpThe console script installed with the package.
python -m edumaths360_mcpSame server, started through the Python module. Useful when you know the interpreter path but not the script path.
uv --directory <path-to-server> run edumaths360-mcpFrom a host configuration. uv installs dependencies if needed.

All three start the server on the stdio transport. The server does not open a network port.

Requirements​

ItemValue
Python3.10 or later (CI uses 3.12)
Runtime dependencymcp>=2.3,<3 (the official MCP Python SDK)
Package nameedumaths360-mcp, version 0.3.0
Server name / titleedumaths360-practice / Edumaths360 Practice Server

Built-in limits​

These values are constants in the source code. They are not configurable at runtime, on purpose: a client should not be able to loosen them.

ConstantValueDefined inPurpose
REVEAL_AFTER_ATTEMPTS3server.pyWrong attempts before check_answer shows the worked solution.
MAX_TRACKED_PROBLEMS10000server.pyMaximum number of problems whose attempt counts are kept in memory. The oldest is forgotten first.
MAX_HINT_LEVEL3problems.pyNumber of hint levels per problem.
MAX_SEED999999problems.pyLargest seed accepted by generate_problem.
problem_id max length32server.pyMaximum length of a problem ID argument.
answer length1 to 100server.pyLength limits for a student's answer.

State​

The only state is the attempt counter used by check_answer. It lives in memory and is lost when the server stops. Each host starts its own server process, so two apps never share attempt counts. Problems themselves are not stored: the problem ID contains everything needed to rebuild the problem.

Logging​

The server logs to stderr at INFO level, in this format:

%(asctime)s %(levelname)s %(name)s: %(message)s

Messages include Starting Edumaths360 Practice Server 0.3.0 on stdio, generated pl-hard-42 and checked pl-hard-42 attempt=1 correct=False. Logs never contain answers or solutions. Hosts such as Claude Desktop capture stderr in their own log files.

:::danger Do not log to stdout On the stdio transport, stdout carries JSON-RPC messages. Anything else written there breaks the connection. See Troubleshooting. :::

Host configuration format​

Claude Desktop and Cursor use the same JSON structure:

{
"mcpServers": {
"<display name>": {
"command": "<program to run>",
"args": ["<argument>", "..."],
"env": {"<NAME>": "<value>"}
}
}
}
KeyRequiredDescription
commandYesThe program to start, for example uv or a full path to python.
argsNoArguments passed to the program.
envNoExtra environment variables. This server does not read any.

For file locations and examples, see Configure Claude Desktop and Cursor.