使用说明

项目简介

GeoGebra MCP Tool 是一个基于 Model Context Protocol (MCP) 构建的应用后端服务器。它通过标准化的 JSON-RPC 协议与 LLM 客户端（如 Claude Desktop）通信，使得 LLM 能够调用 GeoGebra 的数学功能，进行几何作图、函数可视化、代数计算等操作。

主要功能点

几何作图: 支持创建点、线、圆、多边形等基本几何图形。
函数绘图: 能够绘制显式函数 ('f(x) = ...')、参数方程定义的曲线 ('x(t)=..., y(t)=...') 和隐式方程定义的曲线 ('F(x,y) = 0')，并支持定义域和样式设置。
代数计算: 提供求解方程、方程组，计算表达式的导数和积分，以及简化代数表达式等功能。
互动演示: 允许创建可动画的参数（如滑块），并控制对象的动画和轨迹显示，用于构建动态数学演示。
结果导出: 可以将当前的 GeoGebra 构造导出为 PNG、SVG 或 PDF 格式的图像或文档。
教育工具: 提供预设的数学教育模板列表和加载功能，并支持生成包含多个模板的课程计划。
性能监控: 提供获取服务器和实例池状态、性能统计等工具。

安装步骤

GeoGebra MCP Tool 基于 Node.js 环境运行。您需要先安装 Node.js (版本 18.0.0 或更高)。

推荐使用 'npx' 命令直接运行，无需全局安装：

使用 NPX (推荐) 无需任何安装步骤，直接运行： 'npx @gebrai/gebrai' 这会下载并运行最新版本的服务器。

如果您希望全局安装以便更快启动：

全局安装 打开终端，运行以下命令进行全局安装： 'npm install -g @gebrai/gebrai' 安装完成后，您可以通过 'gebrai' 命令启动服务器： 'gebrai'

对于开发者或需要本地修改的用户：

本地开发安装
1. 克隆仓库代码： 'git clone https://github.com/Gebrai/gebrai.git'
2. 进入项目目录： 'cd gebrai'
3. 安装项目依赖： 'npm install'
4. 构建项目： 'npm run build'
5. 启动服务器： 'npm start'

服务器配置 (供MCP客户端使用)

GeoGebra MCP Tool 服务器通过标准输入/输出 (stdin/stdout) 与 MCP 客户端通信。要让您的 MCP 客户端（例如支持 MCP 的 AI 助手）使用此服务器，您需要在客户端的配置中添加 GeoGebra MCP Tool 的启动信息。

配置通常是一个 JSON 结构，指定服务器的名称、启动命令及其参数。

例如，在支持 MCP 的客户端配置中，您可能需要添加类似以下结构的条目（具体格式请参考您的客户端文档）：

服务器名称: 用于标识此 MCP 服务器的唯一名称，如 '"geogebra"'。
启动命令 (command): 启动 GeoGebra MCP Tool 可执行文件的命令。如果您全局安装了，可以是 '"gebrai"'；如果使用 npx，可以是 '"npx"'。
命令参数 (args): 传递给启动命令的参数列表。如果使用 npx，参数列表中需要包含 '"@gebrai/gebrai"'。您还可以添加其他参数，如设置日志级别 ('"--log-level"', '"debug"')。

配置完成后，您的 MCP 客户端即可识别并连接到 GeoGebra MCP Tool。

基本使用方法

一旦 GeoGebra MCP Tool 服务器在您的 MCP 客户端中配置并成功启动，LLM 即可通过 MCP 协议发现并调用其提供的工具。

您可以直接向 LLM 提出数学相关的请求，例如：

要求它绘制函数图象，如“绘制函数 y = x² + 2x - 3 的图像”。
要求它进行几何作图，如“创建一个顶点为 A(1,1), B(5,1), C(3,4) 的三角形”。
要求它进行代数计算，如“求解方程组 x + y = 5 和 x - y = 1”。
要求它生成一个互动演示，如“创建一个抛物线的动画演示”。
要求它导出当前的数学构造，如“将当前 GeoGebra 视图导出为 PNG 图片”。
询问可用的教育模板，如“列出所有适用于高中代数的教育模板”。

LLM 会根据您的请求，自动选择并调用 GeoGebra MCP Tool 中相应的工具来完成任务。

关键词