Skip to main content

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​

{
"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.

Claude Desktop​

  1. Open Settings → Developer → Edit Config. The file is:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Merge the server entry into the file's mcpServers object.
  3. Quit and reopen Claude Desktop.
  4. Check Settings → Developer: edumaths360 should be listed as running.

For a guided walk-through, see the Claude Desktop tutorial.

Cursor​

Cursor reads MCP servers from two places:

FileScope
~/.cursor/mcp.jsonEvery project on your computer.
.cursor/mcp.json in a project folderOnly that project. Commit it to share the setup with your team.
  1. Create or open one of these files and paste the server entry.
  2. Open Cursor's settings and find the MCP section. edumaths360 should appear with its three tools. Enable it if it is switched off.
  3. 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.