SDAMGIA

Provides an MCP server to query and fetch СДАМ ГИА problems, solutions, and answers across multiple subjects via flexible tools.

typescript

2

GitHub Stars

typescript

Language

4 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": {
    "art22017-sdamgia-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "sdamgia-mcp-server"
      ]
    }
  }
}

You can use the Sdamgia MCP Server to enable large language models to search, retrieve, and format problems, solutions, and answers from the СДАМ ГИА platform. This server exposes a robust set of search and retrieval capabilities, supports multiple subjects, and outputs data in convenient formats for downstream processing or human-friendly display.

How to use

After you configure a client to connect to the MCP server, you can perform structured queries to locate and fetch СДАМ ГИА problems. Use the search tools to find problems by keywords or by text similarity, retrieve single or multiple problems with their conditions, solutions, and answers, and browse catalogs and categories to explore related items. Outputs can be consumed as JSON for programmatic workflows or as Markdown for quick review.

How to install

Prerequisites: ensure you have Node.js 18 or newer and a package manager such as npm or yarn installed.

Install the MCP server globally and prepare it for use by your MCP clients.

npm install -g sdamgia-mcp-server
npx sdamgia-mcp-server

# Or clone from source and build
# git clone https://github.com/art22017/sdamgia-mcp-server.git
# cd sdamgia-mcp-server
# npm install
# npm run build
# npm run start

Additional setup notes

The server supports multiple client configurations through MCP-compatible profiles. The following is a representative local/runtime configuration that enables a stdio-based connection using a common runtime command.

{
  "mcpServers": {
    "sdamgia": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "sdamgia-mcp-server"]
    }
  }
}

Available tools

sdamgia_get_problem

Retrieve a specific problem by subject and ID, returning the full problem details including condition, solution, and answer.

sdamgia_search_problems

Search for problems by text query within a subject, with optional limit and output format.

sdamgia_search_by_text

Find problems by condition text using fuzzy matching to handle paraphrased or OCR-imperfect text.

sdamgia_batch_get_problems

Fetch multiple problems in a single request by providing a list of problem IDs.

sdamgia_get_catalog

Retrieve the complete catalog structure for a given subject.

sdamgia_get_category_problems

Get all problems from a specific catalog category with an optional limit.

sdamgia_get_test

Retrieve all problems belonging to a specific test by its ID.