Skip to main content

Connect the server to Claude Desktop

In this tutorial you will install the Edumaths360 Practice Server on your computer and connect it to Claude Desktop. You will then run a short practice session where Claude asks questions instead of giving answers.

Time: about 10 minutes. Level: beginner.

What you need​

  • Claude Desktop for macOS or Windows.
  • Python 3.10 or later and uv.
  • Git, to download the code.

Step 1: Download and test the server​

git clone https://github.com/Creator-hub24/edumaths360-mcp-docs.git
cd edumaths360-mcp-docs/server
uv sync --extra dev
uv run pytest -q

All tests should pass. The last line of the output reports how many passed.

Now find the absolute path of the server folder. You will need it in step 3.

pwd
# Example output: /Users/you/edumaths360-mcp-docs/server

Step 2: Open the Claude Desktop configuration file​

In Claude Desktop, open Settings → Developer → Edit Config. This opens (and creates, if needed) the configuration file:

~/Library/Application Support/Claude/claude_desktop_config.json

Step 3: Register the server​

Add an edumaths360 entry under mcpServers. Replace the path with the one you found in step 1.

claude_desktop_config.json
{
"mcpServers": {
"edumaths360": {
"command": "uv",
"args": [
"--directory",
"/Users/you/edumaths360-mcp-docs/server",
"run",
"edumaths360-mcp"
]
}
}
}

What this means:

  • command and args are the command Claude Desktop runs to start the server. Here, uv --directory <path> run edumaths360-mcp starts the server from the project's own virtual environment.
  • edumaths360-mcp is the console command defined in server/pyproject.toml under [project.scripts].
  • Claude Desktop starts the server as a child process and talks to it over stdio.

:::tip If Claude Desktop cannot find uv Desktop apps do not always see the same PATH as your terminal. If the server does not start, replace "uv" with the full path from which uv (macOS) or where.exe uv (Windows). :::

If the file already has other servers, add edumaths360 next to them inside the same mcpServers object. JSON does not allow trailing commas, so check the commas carefully.

Step 4: Restart Claude Desktop​

Quit Claude Desktop completely and open it again. Configuration is read only at start-up.

Open Settings → Developer. You should see edumaths360 in the list with a running status. In a chat, the tools menu should list generate_problem, check_answer and get_hint.

Step 5: Run a practice session​

Try one of these:

  1. Use the prompt. Claude Desktop lists MCP prompts in the chat input's "+" (attach) menu. Pick Socratic CAT tutor from the edumaths360 server and enter a topic such as profit_loss and difficulty hard. Menu names can change between Claude Desktop versions.
  2. Just ask. Type: "I'm preparing for CAT. Give me a hard profit and loss question to practise, and don't tell me the answer."

Claude calls generate_problem and shows you the question. Answer it with a typical mistake, for example working out the gain percentage on the old selling price instead of the cost price. Claude calls check_answer, and the server replies with targeted feedback ("The gain % is worked out on the cost price…") instead of the correct answer. Ask for a hint and Claude calls get_hint at level 1.

Claude Desktop asks for your permission before it calls a tool. This is the human-in-the-loop control described in the security model.

Video walkthrough: coming soon

A short walkthrough video (under 3 minutes) will appear here. It will show the server running in Claude Desktop: generating a problem, giving a hint, and marking an answer.

Placeholder: the video has not been recorded yet, so there is no link.

If something goes wrong​

  • Check the server's log file. Claude Desktop writes one log per server: ~/Library/Logs/Claude/mcp-server-edumaths360.log on macOS, or %APPDATA%\Claude\logs\ on Windows. The server writes its log lines to stderr, so they appear there.
  • Run the server with the MCP Inspector to rule out Claude Desktop.
  • See Troubleshooting.

Next steps​