GeoGebra MCP Tool
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
GeoGebra MCP Tool
A Model Context Protocol (MCP) server that enables AI models to interact with GeoGebra's mathematical software suite for creating interactive mathematical visualizations and dynamic constructions.
π― Overview
The GeoGebra MCP Tool bridges the gap between AI reasoning capabilities and mathematical visualization, allowing AI assistants to:
Create geometric constructions (points, lines, circles, polygons)
Plot mathematical functions and graphs
Perform algebraic computations with visual representation
Generate interactive mathematical demonstrations
Export visualizations in various formats
Related MCP server: GeoGebra MCP Server
π Quick Start Examples
NPX (Recommended):
# Start the server
npx @gebrai/gebrai
# Or with custom log level
npx @gebrai/gebrai --log-level debugConnect to Claude Desktop - Add to your Claude configuration:
{
"mcpServers": {
"geogebra": {
"command": "npx",
"args": ["@gebrai/gebrai"]
}
}
}Multi-Platform Support - Claude Desktop, Cursor, Windsurf, VS Code (Cline/Roo Code/Copilot), Continue.dev, JetBrains, LibreChat, and Docker! Check the Multi-Platform Setup Guide or run
npm run setup:platformsfor automated setup.
π¦ Installation Options
NPX (No Installation)
npx @gebrai/gebraiβ
No installation required
β
Always uses latest version
β
Perfect for testing
Global Installation
npm install -g @gebrai/gebraiβ
Faster startup after installation
β
Works offline
β
Consistent version
Local Development
git clone <repository-url>
cd gebrai && npm installβ
Full source code access
β
Customization possible
β
Development workflow
π οΈ CLI Usage
The GeoGebra MCP Tool provides a command-line interface with the following options:
Usage:
npx @gebrai/gebrai [options]
gebrai [options] # if installed globally
geogebra-mcp [options] # alternative command
Options:
-h, --help Show help message
-v, --version Show version information
--log-level LEVEL Set log level (error, warn, info, debug) [default: info]
--port PORT Set server port [default: stdin/stdout for MCP]
Examples:
npx @gebrai/gebrai # Start MCP server
npx @gebrai/gebrai --log-level debug # Start with debug logging
npx @gebrai/gebrai --help # Show helpPrerequisites
Node.js 18.0.0 or higher
npm or yarn package manager
Installation
Clone the repository:
git clone <repository-url>
cd gebraiInstall dependencies:
npm installBuild the project:
npm run buildStart the server:
npm startDevelopment Mode
For development with hot reload:
npm run devπ οΈ Development
Project Structure
gebrai/
βββ src/
β βββ index.ts # Main entry point
β βββ server.ts # MCP server implementation
β βββ types/
β β βββ mcp.ts # MCP protocol types
β βββ tools/
β β βββ index.ts # Tool registry and example tools
β βββ utils/
β βββ logger.ts # Logging utility
β βββ errors.ts # Error handling
βββ tests/
β βββ setup.ts # Test configuration
β βββ server.test.ts # Server tests
βββ package.json
βββ tsconfig.json
βββ README.mdAvailable Scripts
npm run dev- Start development server with hot reloadnpm run build- Build the TypeScript projectnpm start- Start the production servernpm test- Run the test suitenpm run test:watch- Run tests in watch modenpm run test:coverage- Run tests with coverage reportnpm run lint- Run ESLintnpm run lint:fix- Fix ESLint issues automatically
Testing
The project includes a comprehensive test suite using Jest:
# Run all tests
npm test
# Run tests in watch mode
npm run test:watch
# Generate coverage report
npm run test:coverageπ Documentation
For comprehensive documentation, visit our complete documentation which includes:
π Core Documentation
API Reference - Complete tool documentation with examples
Getting Started Guide - Step-by-step setup and first usage
Integration Guide - Platform integration instructions
Troubleshooting - Common issues and solutions
FAQ - Frequently asked questions
π§ Tool Categories
Basic Tools - Core MCP functionality (ping, echo, server_info)
GeoGebra Tools - 25+ mathematical construction tools
Educational Tools - Pre-built educational templates
Performance Tools - Monitoring and optimization
π Educational Resources
Use Cases - Real-world educational scenarios
Teacher Guide - Pedagogical guidance
Classroom Examples - Ready-to-use lessons
π Tutorials & Examples
Basic Usage - Your first mathematical constructions
Mathematical Constructions - Geometry and algebra
Function Plotting - Creating mathematical functions
Code Examples - Working examples by complexity
π Tool Overview
The GeoGebra MCP Tool provides 40+ tools across four categories:
Category | Tools | Description | Performance |
Basic | 3 tools | Core MCP functionality | < 100ms |
GeoGebra | 25+ tools | Mathematical constructions | < 2000ms |
Educational | 10+ tools | Classroom activities | < 2000ms |
Performance | 5 tools | Monitoring & optimization | < 500ms |
Example Tools
Mathematical:
geogebra_create_point,geogebra_plot_function,geogebra_export_pngEducational:
geogebra_list_educational_templates,geogebra_create_lesson_planPerformance:
performance_get_stats,performance_warm_up_pool
π§ Configuration
Environment Variables
PORT- Server port (default: 3000)LOG_LEVEL- Logging level: error, warn, info, debug (default: info)NODE_ENV- Environment: development, production, test
Example .env file
PORT=3000
LOG_LEVEL=info
NODE_ENV=developmentποΈ Architecture
Core Components
MCP Server (
src/server.ts)Handles JSON-RPC 2.0 protocol
Routes requests to appropriate handlers
Manages server lifecycle
Tool Registry (
src/tools/index.ts)Manages available tools
Handles tool execution
Provides tool discovery
Error Handling (
src/utils/errors.ts)Standardized error responses
JSON-RPC error codes
Comprehensive error logging
Logging (
src/utils/logger.ts)Structured logging with Winston
Configurable log levels
Development and production modes
Design Principles
Type Safety: Full TypeScript implementation with strict mode
Error Handling: Comprehensive error handling and validation
Modularity: Clean separation of concerns
Testability: Extensive test coverage
Extensibility: Easy to add new tools and features
π€ Contributing
Fork the repository
Create a feature branch:
git checkout -b feature/new-toolMake your changes and add tests
Ensure all tests pass:
npm testCommit your changes:
git commit -m 'Add new tool'Push to the branch:
git push origin feature/new-toolSubmit a pull request
Development Guidelines
Follow TypeScript best practices
Add tests for new functionality
Update documentation as needed
Use conventional commit messages
Ensure code passes linting
π Related Projects
π Support
For questions, issues, or contributions, please:
Check the Issues page
Create a new issue if needed
Join our community discussions
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Create interactive 2D and 3D graphs with validated equations, shareable links, and PNG previews.
Renders interactive Chart.js charts and dashboards inline in AI conversations.
Draw architecture diagrams, UML, planning boards and clickable wireframes from your AI assistant.
Lets AI assistants draw: logos, posters, illustrations and scenes, as editable SVG and PNG.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables mathematical formula visualization and analysis through interactive plotting, formula validation, and symbolic computation. Supports both Desmos API integration and local matplotlib rendering for creating 2D mathematical graphs.510Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides access to GeoGebra's mathematical computation, geometry construction, and visualization capabilities. Enables mathematical calculations, CAS operations, geometric constructions, and exporting results as PNG or PDF images.14MIT
- AlicenseNot gradedqualityDmaintenanceEnables creating interactive mathematical visualizations like function graphs, geometry diagrams, and parametric curves using JSXGraph.25 npm6MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI to interact with GeoGebra for mathematical visualization, offering over 25 tools for geometry, functions, algebra, and more.MIT