
SageMath
io.github.XBP-Europe由 GitHub 账号 XBP-Europe 发布v0.10.1更新于 Nov 11, 2026
Stateful SageMath MCP server with 40 tools and a sandboxed Sage session per client.
发布方自己的服务:Math.Tools MCP Server
概览
运行带沙箱、可保持状态的 SageMath 会话,让助手完成符号运算、线性代数、微分方程、数论与绘图。
- 可以做什么
- 在持久会话中执行 Sage 代码,支持流式输出、重置、中断、取消以及命名工作区
- 通过证明阶梯复核给定结论,返回 proved、refuted、supported 或 undecided
- 求导、积分、求极限、级数展开、解方程与化简、因式分解与展开、符号求和
- 处理矩阵、常微分方程、数论、组合数学、图论、群论、椭圆曲线、编码理论、多项式、布尔代数、几何、统计与概率分布
- 绘制二维与三维图形、数值求根、向量微积分,并检查服务健康状态或查询 Sage 文档
- 适用场景
- 适合需要助手真正计算并核验数学结果而非近似作答的场景:符号微积分、精确代数、微分方程、数论或图论与群论问题,尤其是变量需在多次调用间保留的多步推导。
- 运行要求
- 在 macOS 或 Linux 上作为本地进程运行(Windows 仅能通过容器或 WSL)。需要 Python 3.12 和 SageMath 运行时:passagemath 附加包、PATH 中已有的 sage、conda-forge,或容器镜像。uvx 方式需要 uv,首次启动约下载 1 GB 的 Sage 组件。无需认证或 API 密钥。
安装
在 SourceWeft 中
- 打开 控制台中的 SageMath,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
SageMath MCP Server
[CI] [CodeQL] [Dependency audit] [Fuzz] [Release] [PyPI] [conda-forge] [GHCR] [License] [Python] [MCP] [FastMCP] [SageMath] [Ruff] [Typed] [Coverage] [Sage doctests] [Downloads] [MCP Registry] [Glama] [Signed] [Provenance] [PyPI attestations] [OpenSSF Scorecard] [DOI] [Dependabot] [Last commit]
A Model Context Protocol server that gives an
LLM a sandboxed mathematical subset of SageMath —
symbolic calculus, number theory, linear algebra, ODEs, plotting, combinatorics,
graphs, groups, elliptic curves, and more. Each MCP session gets a dedicated Sage
worker process, so variables, functions, and assumptions persist across tool
calls. It ships 40 MCP tools, one of which — verify_claim — re-checks a
stated result through a proof ladder and answers proved / refuted /
supported / undecided with its evidence.
Caller code is deny-by-default: the full breadth of Sage mathematics is reachable, but imports, the external CAS interfaces, and the file / display / persistence primitives are not. The policy accepts 98.9% of SageMath's own 438,124 documented doctest examples (4,259 in-scope refusals, every one attributed to a named rule; 98.9% of 433,687 on the passagemath runtime) while refusing the rest — measured on every CI run (see Security).
Full manual: USAGE.md — the tools and their parameters, how code is interpreted, and the security model in depth.
Install & run
Recommended — pip, with the passagemath Sage runtime:
or, with uv and nothing installed permanently,
uvx --python 3.12 --from "sagemath-mcp[passagemath]" sagemath-mcp. This is the
route every client install below takes.
Use Python 3.12 for this extra; the uvx line asks for it, and uv downloads it
when the machine has none. 3.12 is the version CI tests it on, and the newest
for which every dependency ships a wheel: on 3.13 and later memory-allocator
is compiled from source, which needs a C compiler. Without --python, uv picks
its own newest Python (3.15 at the time of writing), and the install fails there.
passagemath is a pip-installable, modularized SageMath. from sage.all import *
and the worker run unmodified; the server detects the runtime at import and
loads the matching security artifacts, so the deny-by-default policy is
equivalent on both. It is pinned exactly (passagemath-standard==10.8.13) and
exercised by its own CI lane — the whole suite plus the doctest-corpus sweep
against the pin — so a pin bump is verified end to end before it ships, and the
last two releases passed that gate on first try
(docs/passagemath_evaluation.md).
macOS and Linux; native Windows support is partial, so on Windows use the
container or WSL.
A pip install runs with your own privileges. The security policy refuses code that reaches outside mathematics, but it is not an operating-system boundary (SECURITY.md). That suits your own client on your own machine. For untrusted input, a shared host or multi-tenant use, run the container.
For isolation — the container image (SageMath is baked in):
Those flags are the hardening the server expects; the port is published on
loopback deliberately — the server executes code and authenticates nobody.
docker compose up --build applies the same hardening from one reviewed file.
Released images are signed with Cosign and carry SLSA provenance and an SPDX
SBOM as registry attestations; the PyPI files carry PEP 740 attestations.
DISTRIBUTION.md
shows how to verify each.
On arm64 (Apple silicon, Graviton): the passagemath image. The monolithic
image above is published for linux/amd64 only, so on arm64 it runs under
emulation. The same server on the passagemath runtime ships as a native
linux/amd64 + linux/arm64 image, with the same hardening flags, UID and
security policy:
Every release tag has a -passagemath twin (vX.Y.Z-passagemath), each
architecture is smoke-tested natively before it is published, and the index is
signed and attested like the primary image. It is the optional image on amd64,
where the monolithic one stays primary.
One click in a desktop MCP host (Claude Desktop and friends): download
sagemath-mcp-<version>.mcpb from the
latest release and
open it. The bundle is about 27 KB; your host installs the server and
a Sage runtime with uv on first launch, which is roughly a 1 GB download once.
macOS and Linux — native Windows is excluded because passagemath's Windows
support is partial. A bundle is a local install with your own privileges; for
untrusted or multi-tenant use run the container instead.
With a Sage you already have (PyPI):
This needs a working SageMath on the host: sage on your PATH, or in the same
environment as the server. A Sage inside a container is out of reach of a server
on the host; without a Sage of your own, use the [passagemath] extra above.
From conda-forge (Linux and macOS, next to conda-forge's Sage):
The version floor matters: earlier releases cannot start a worker on
conda-forge's sage unless its environment is activated, which an MCP client
does not do, and without the floor the solver may pick one. That sage is
10.10, the release the security artifacts are generated from.
Source install, Docker Compose, and the Kubernetes Helm chart are in USAGE.md.
Connect an MCP client
One command or one click each. Every route below installs a Sage runtime alongside the server, so there is nothing else to set up.
[Install in VS Code] [Install in Cursor]
Claude Desktop — download sagemath-mcp-<version>.mcpb from the
latest release and
open it. One click, no config file.
Claude Code — as a plugin from this repository's marketplace, inside a session:
or as a plain MCP server:
Gemini CLI — the repository is itself an extension:
Codex CLI
Then ask for some mathematics — the examples below are a good start.
Three things worth knowing. These need uv on your
PATH, and the first launch downloads about 1 GB of Sage wheels, cached
afterwards. Already have sage? Drop [passagemath] from the specification and
it will use yours. Installed from conda-forge? Register the environment's own
executable, for example claude mcp add sagemath -- ~/miniforge3/envs/sage/bin/sagemath-mcp;
it finds the sage beside it without the environment being activated. And an install of any of these runs with your own privileges;
for untrusted or shared use, run the container and point the client at it.
Pinning a release, HTTP transport and the full client reference are in USAGE.md.
Try it
Prompts a client can run once the server is connected:
- Damped harmonic oscillator — "Solve
x'' + 2·x' + 5·x = 0withx(0)=1,x'(0)=0, then verify the solution satisfies the ODE." - General relativity — "On the hyperbolic upper half-plane with metric
(dx² + dy²)/y², compute the Ricci scalar and confirm it is a constant negative curvature." - Coupled two-tank system — "Solve the linear ODE system for two mixing tanks, then take the long-term limit of each concentration."
Each builds an object once and explores it across calls — the case for
evaluate_sage and its persistent session.
The 40 tools
The math tools use SageMath as the backend; parameters and examples for the most-used ones are in USAGE.md.
Plus HTTP /health and /ready endpoints and 3 MCP resources (session
snapshots, monitoring metrics, doc links). Prefer interrupt_sage_session over
cancel_sage_session — it stops a computation while keeping the session's
variables.
How it works
Request flow: MCP client → a tool in tools/ →
SageSessionManager.get() → SageSession.evaluate() → JSON request to
the _sage_worker.py subprocess → AST validation → exec() in the persistent
namespace → JSON response.
- Process isolation — each session runs Sage in its own subprocess; a crash or timeout in one cannot affect another.
- Stateful sessions — variables, functions, and assumptions persist across calls, enabling multi-step workflows.
- Deny-by-default — a name is refused unless the generated allowlist offers it or the caller's own code bound it. A helper a future SageMath adds is refused until someone reviews it, rather than reachable the day it lands.
Security
The AST validator is defence in depth against accidents and casual misuse — it
is not a boundary against determined adversarial code. The container is the
security boundary. The server has no authentication, so every default is
loopback: --host defaults to 127.0.0.1, the default transport is stdio, and
Compose / Helm keep the endpoint off the network. Put something that
authenticates in front of it before exposing it.
What the policy enforces: an allowlist (caller code may read only a name the
server offers or the caller itself bound); no imports by default; eval /
exec / compile and runtime string evaluation blocked; dunder access blocked;
the external CAS interfaces and every file / network / persistence primitive
removed from the namespace, by provenance rather than by name; and the sage
package tree closed to caller code, so a helper is reached by its own name or
not at all. The container adds
a read-only root, dropped capabilities, no-new-privileges, the default
seccomp profile, and memory ceilings. Compose adds a fork (PID) ceiling;
Kubernetes has no per-pod equivalent in the pod spec, so on the chart that is
the node's podPidsLimit rather than something the chart can set.
Full threat model and the complete blocked / allowed tables: SECURITY.md and USAGE.md § Security model.
Docs & more
- USAGE.md — the full manual: every tool, how code is interpreted, deployment, and the security model.
- docs/mcp_quickstart.md — a first-session walk-through.
- CHANGELOG.md · ROADMAP.md · CONTRIBUTING.md · SECURITY.md · SUPPORT.md — what "supported" means, release cadence, where to ask. PRIVACY.md — what the server keeps (nothing leaves the machine it runs on).
Requirements
Python 3.12+ and a SageMath runtime (the container image bundles SageMath 10.10;
otherwise sage on PATH, or the [passagemath] extra). Built on
FastMCP 4.x.
Contributing
Issues and pull requests welcome — see CONTRIBUTING.md. Run
make lint, make typecheck and make test before pushing
(git config core.hooksPath .githooks wires the pre-push check). Roadmap and open work: ROADMAP.md.
Questions go to GitHub Discussions;
SUPPORT.md says what to expect.
Citing
If this server is part of published work, cite it via CITATION.cff — GitHub renders it as Cite this repository in the sidebar, with APA and BibTeX. Cite SageMath itself as well; it does the mathematics.
License
MIT — see LICENSE. SageMath itself is GPL-2.0-or-later and is used as a separate runtime; no SageMath source is redistributed in this repository.
来源:README.md,提交 f099ad4
工具
0版本历史
14- v0.10.1最新Nov 11, 2026
- v0.9.7Oct 26, 2026
- v0.9.6Oct 25, 2026
- v0.9.5Oct 13, 2026
- v0.9.4Oct 10, 2026
- v0.9.3Oct 5, 2026
- v0.9.2Sep 28, 2026
- v0.9.1Sep 24, 2026
- v0.9.0Sep 24, 2026
- v0.8.4Sep 22, 2026
- v0.8.3Sep 20, 2026
- v0.8.2Sep 18, 2026
- v0.8.1Sep 17, 2026
- v0.8.0Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
其他 Math 集成
Math.Tools MCP Server
tools.math官方发布者
远程 math.tools 服务,让助手进行数论检查、数字与进制转换、圆周率数字、数字拼写以及公式图片渲染。

Rate Setting Math Tracker
由 GitHub 账号 mrfentmen 发布
本地 MCP 服务器,对自由职业者定价计算进行 JSON 分析,提供 25 个工具且无付费墙。

Rate Setting Math Simulator
由 GitHub 账号 mrfentmen 发布
一个本地 MCP 服务器,基于 JSON 数据计算自由职业者的费率设定数学,提供 25 个工具且无付费墙。

Rate Setting Math Planner
由 GitHub 账号 mrfentmen 发布
一个本地 stdio MCP 服务器,基于本地 JSON 数据分析自由职业者定价与费率计算,提供 25 个工具且无付费墙。

Rate Setting Math Archive
由 GitHub 账号 mrfentmen 发布
本地 MCP 服务器,基于内置 JSON 数据对自由职业者定价(费率设定)数学进行分析,提供 25 个工具且无付费墙。