СДАМ ГИА MCP Server

MCP (Model Context Protocol) server for interacting with the СДАМ ГИА educational platform. This server enables LLMs to search and retrieve exam problems, solutions, and answers across multiple subjects.

Features

🔍 Smart Search

• Text Search: Search problems by keywords
• Fuzzy Text Matching: Find problems by condition text with approximate matching
• Catalog Browsing: Explore problems by topics and categories

📚 Problem Retrieval

• Single Problem: Get complete problem details including condition, solution, and answer
• Batch Fetch: Retrieve multiple problems efficiently in one request
• Analog Problems: Discover similar problems automatically

📊 Structured Data

• Multiple Formats: Output in JSON or Markdown
• Rich Metadata: Access images, topics, and problem relationships
• Type Safety: Full TypeScript support with Zod validation

Supported Subjects

• math - Mathematics (профильная)
• mathb - Mathematics (базовая)
• rus - Russian Language
• phys - Physics
• chem - Chemistry
• bio - Biology
• geo - Geography
• hist - History
• soc - Social Studies
• inf - Informatics
• en - English
• de - German
• fr - French
• sp - Spanish
• lit - Literature

Installation

Prerequisites

• Node.js 18+ or 20+
• npm or yarn

Install

npm install
npm run build

Installation

Via npm (Recommended)

npm install -g sdamgia-mcp-server

Or use without installation via npx:

npx sdamgia-mcp-server

From Source

git clone https://github.com/art22017/sdamgia-mcp-server.git
cd sdamgia-mcp-server
npm install
npm run build

Configuration

The server can be configured with any MCP-compatible client. Below are instructions for popular platforms:

Claude Code

Config file locations:

• User scope: ~/.claude.json (available across all projects)
• Project scope: .mcp.json in project root (shared with team)

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

Alternative: Via CLI

claude mcp add sdamgia --scope user npx -y sdamgia-mcp-server

Cursor

Config file locations:

• Project: .cursor/mcp.json (in project directory)
• Global: ~/.cursor/mcp.json (home directory)

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

Or via UI: Settings → Tools & Integrations → MCP Servers → Add New MCP Server

Kilocode

Config file locations:

• Project: .kilocode/mcp.json
• Global: Via Settings → MCP Servers → Edit Global MCP

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

Note: VS Code and CLI configurations are separate in Kilocode.

Google Antigravity

Config file locations:

• macOS/Linux: ~/.config/antigravity/mcp.json or ~/.gemini/antigravity/mcp_config.json
• Windows: %APPDATA%\antigravity\mcp.json

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

Or via UI: Agent panel → Three-dot menu → MCP Servers → Manage MCP Servers

Gemini CLI

Config file location: ~/.gemini/settings.json

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

MCP Inspector (for testing)

npx @modelcontextprotocol/inspector npx -y sdamgia-mcp-server

Usage

Once configured, restart your AI assistant and the server will be available. Use the tools described below.

Available Tools

1. sdamgia_get_problem

Retrieve a specific problem by ID.

Parameters:

• subject (required): Subject code (e.g., "math", "phys")
• `p

... View full README on GitHub