Skip to main content
Glama
mcp-geometry-prover

mcp-geometry-prover

by MikeyBeez

MCP Geometry Prover

An MCP server that wraps AlphaGeometry2's DDAR (Deductive Database with Algebraic Reasoning) engine for geometry theorem proving.

Overview

This server provides Mikey Agent with the ability to prove geometry theorems using the same symbolic reasoning engine that powered Google DeepMind's IMO gold-medalist performance.

Related MCP server: Aristotle MCP Server

Tools

geometry_prove

Prove a geometry theorem using DDAR.

Input: Problem in AG2 format Output: Proof status and number of deduction steps

geometry_example

Get example problems from IMO competitions.

geometry_help

Documentation on the AG2 format and DDAR.

AG2 Problem Format

a@x_y = ; b@x_y = ; ...  (points with coordinates)
pred1, pred2, ...        (constraints)
? goal_predicate         (what to prove)

Predicates

  • coll a b c - collinear

  • cong a b c d - |AB| = |CD|

  • perp a b c d - AB ⟂ CD

  • para a b c d - AB ∥ CD

  • cyclic a b c d - concyclic

  • eqangle a b c d e f g h - ∠(AB,CD) = ∠(EF,GH)

Architecture

┌─────────────────────┐
│   Mikey Agent       │
│   (Claude Code)     │
└──────────┬──────────┘
           │ MCP
           ▼
┌─────────────────────┐
│  mcp-geometry-prover│
│   (TypeScript)      │
└──────────┬──────────┘
           │ spawn Python
           ▼
┌─────────────────────┐
│  AlphaGeometry2     │
│  DDAR Engine        │
│   (Python)          │
└─────────────────────┘

Dependencies

  • Node.js 18+

  • Python 3.10+ with numpy

  • AlphaGeometry2 repo at ~/Code/alphageometry2

Setup

# Build
npm install
npm run build

# AG2 setup (one-time)
cd ~/Code/alphageometry2
python3 -m venv ag2_env
source ag2_env/bin/activate
pip install numpy

Next Steps

  1. Elvis Integration: Use local LLM to suggest auxiliary constructions when DDAR fails

  2. Natural Language: Parse geometry problems from natural language

  3. Proof Export: Generate human-readable proofs

License

MIT (wrapper code) Apache 2.0 (AlphaGeometry2)

Available Tools

3 tools
geometry_exampleA

Get an example geometry problem in AG2 format

Inputs: problem_id (required).

geometry_helpA

Get help on the geometry prover and AG2 format

Inputs: no named parameters.

geometry_proveB

Prove a geometry theorem using AlphaGeometry2's DDAR engine.

Input format (AG2 problem string):

  • Points with coordinates: "a@x_y = ;"

  • Constraints: "coll a b c" (collinear), "cong a b c d" (congruent), "perp a b c d" (perpendicular), "para a b c d" (parallel), "cyclic a b c d" (concyclic), "eqangle a b c d e f g h" (equal angles)

  • Goal after "?": "cong e p e q" (prove EP = EQ)

Example (IMO 2000 P1): "a@-0.52_0.11 = ; b@-0.19_0.19 = ; ... cong a g1 g1 m, ... ? cong e p e q"

Returns proof status and number of deduction steps.

Inputs: problem (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: one provides examples, one offers help, and one performs proofs. There is no overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow the consistent pattern 'geometry_<noun>', making them predictable and easy to distinguish.

    Tool Count5/5

    With only three tools, the server is well-scoped for its specialized domain of geometry proving, covering essential functionalities without excess.

    Completeness5/5

    The tool set covers the complete workflow: getting started (example), learning (help), and executing proofs (prove). No obvious gaps are present.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides symbolic reasoning capabilities by converting natural language logical problems into Answer Set Programming (ASP) format and solving them using the Clingo solver. Enables users to perform formal logical reasoning, verify logical arguments, and get step-by-step explanations for complex logical problems.
      5
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides exact arithmetic and verification tools using SymPy and fractions to solve math competition problems precisely. It enables users to perform rigorous calculations and export notebook-ready Python code for further analysis.
      -