Configure Claude Desktop and Cursor
Both apps use the same mcpServers JSON format. Each entry tells the app which command starts the server. The app then launches the server as a child process and talks to it over stdio.
Before you start: clone the repository and run uv sync --extra dev in server/. Note the absolute path of the server folder; the examples use /ABSOLUTE/PATH/TO/edumaths360-mcp-docs/server.
Server entry
- Using uv (recommended)
- Using a virtual environment
{
"mcpServers": {
"edumaths360": {
"command": "uv",
"args": ["--directory", "/ABSOLUTE/PATH/TO/edumaths360-mcp-docs/server", "run", "edumaths360-mcp"]
}
}
}
uv run makes sure the server's dependencies are installed before it starts.
{
"mcpServers": {
"edumaths360": {
"command": "/ABSOLUTE/PATH/TO/edumaths360-mcp-docs/server/.venv/bin/python",
"args": ["-m", "edumaths360_mcp"]
}
}
}
On Windows, the interpreter is at server\.venv\Scripts\python.exe. Use double backslashes in JSON, for example "C:\\Users\\you\\edumaths360-mcp-docs\\server\\.venv\\Scripts\\python.exe".
Claude Desktop
- Open Settings → Developer → Edit Config. The file is:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Merge the server entry into the file's
mcpServersobject. - Quit and reopen Claude Desktop.
- Check Settings → Developer:
edumaths360should be listed as running.
For a guided walk-through, see the Claude Desktop tutorial.
Cursor
Cursor reads MCP servers from two places:
| File | Scope |
|---|---|
~/.cursor/mcp.json | Every project on your computer. |
.cursor/mcp.json in a project folder | Only that project. Commit it to share the setup with your team. |
- Create or open one of these files and paste the server entry.
- Open Cursor's settings and find the MCP section.
edumaths360should appear with its three tools. Enable it if it is switched off. - In the agent chat, ask: "Use the edumaths360 tools to give me a hard time and work question to practise for CAT."
:::tip Project-relative paths
In a project-level .cursor/mcp.json, you can avoid hard-coding your home folder by using Cursor's ${workspaceFolder} variable, for example "--directory", "${workspaceFolder}/server". Check the Cursor MCP documentation for the variables your version supports.
:::
Optional settings
The server needs no environment variables, API keys or network access. If you add a server that does need a secret, pass it with the env key rather than in args, and never commit the file that contains it:
{
"mcpServers": {
"example": {
"command": "uv",
"args": ["run", "example-server"],
"env": {"EXAMPLE_API_KEY": "set-this-locally"}
}
}
}
See the configuration reference for every option the Edumaths360 server supports.
Check that it works
If the server does not appear, run the exact same command in a terminal with the MCP Inspector. If it works there, the problem is in the app's configuration (usually the path or a JSON syntax error), not in the server.