Skip to main content
Glama

Inglés · 简体中文

Jacobian es un servidor MCP que ofrece a los agentes de IA un vocabulario buscable de operaciones matemáticas tipadas. math.find descubre una operación, y math.run ejecuta exactamente un contrato matemático acotado y devuelve su resultado tipado. La misma biblioteca matemática también está disponible a través de una CLI y una API nativa de Python.

Cada operación establece una postcondición matemática estable y reutilizable, en lugar de prescribir un flujo de trabajo o una estrategia de demostración. Los resultados son exactos cuando así se indica y hacen explícitos la aproximación, la incompletitud o la incertidumbre.

La hipótesis de Jacobian es que el razonamiento matemático se beneficia de un vocabulario ejecutable de operaciones acotadas y con delimitación semántica. En lugar de exponer grandes solucionadores de dominio o flujos de trabajo precompuestos, Jacobian expone primitivas matemáticas que los agentes pueden buscar y componer en soluciones más allá de lo que cualquier operación individual fue diseñada para resolver. La biblioteca aporta movimientos matemáticos fiables; el modelo de razonamiento decide qué movimientos hacer, cómo combinar sus resultados y cuándo detenerse. Mantener las operaciones semánticamente acotadas y propias del dominio preserva ese espacio de búsqueda, en lugar de osificar una única estrategia de demostración o un único flujo de trabajo dentro de las propias herramientas.

Consulta Vocabulario matemático ejecutable para entender qué significa la atomicidad semántica y cómo crece el vocabulario de operaciones.

Inicio rápido

Ejecuta el comando canónico de MCP para Python sin instalar Jacobian globalmente:

uvx --from jacobian jacobian-mcp

Cuando un host MCP exige un comando npm, el paquete npm es un portador determinista de ese mismo comando:

npx jacobian mcp

Para una instalación persistente:

python -m pip install jacobian
jacobian-mcp

Ese paquete incluye la pila de backend exacta y mantenida por Jacobian: SymPy, NetworkX, Z3 y Python-FLINT. Una instalación normal de Python o npm expone, por tanto, el mismo catálogo de operaciones integradas respaldadas por Python. El contrato de instalación binaria probado es CPython 3.12 o 3.13 en glibc Linux x86-64; la pasarela de publicación instala el wheel compilado y arranca Jacobian en ambas versiones de Python. Otros sistemas pueden tener wheels aguas arriba compatibles, pero aún no forman parte del contrato de publicación probado. En concreto, Alpine/musl no puede instalar la pila obligatoria completa desde PyPI.

La distribución de Python contiene el núcleo matemático, la CLI y el servidor MCP. El paquete npm relaciona de forma determinista su versión exacta del paquete con la invocación correspondiente de uvx.

Related MCP server: math-logic-mcp

Calcular un resultado acotado

Una operación ordinaria devuelve primero las matemáticas. Por ejemplo, matrix.determinant.compute acepta una matriz racional exacta y devuelve su determinante directamente. Los llamadores componen resultados pasando sus valores tipados a una operación posterior.

Matemáticas disponibles

El catálogo integrado cubre:

  • mapas polinomiales y álgebra polinomial;

  • álgebra lineal exacta;

  • grafos, caminos, coloraciones e isofórmico;

  • resolución acotada de SAT y SMT;

  • álgebra finita, probabilidad, de gramatría y topología; y

  • elaboración de código fuente en Lean.

Las operaciones de SAT y SMT usan directamente el binding de Python de Z3 mantenido. La operación opcional lean.check ejecuta un fragmento de código acotado en el entorno fijo del servicio Lean, utilizando un directorio temporal con ámbito de solicitud y devolviendo diagnósticos tipados. Utiliza math.find para buscar una operación, explorar un dominio desconocido e inspeccionar una operación antes de llamar una olvida a math.run.

Consulta el catálogo de operaciones por dominio para conocer la cartera de operaciones mantenida y los requisitos de backend.

Estado

Jacobian 0.12.0 es pre-estable. Los contratos de paquete y de operaciones publicados describen la superficie compatible; los contratos de operaciones experimentales pueden cambiar entre versiones.

Documentación

Contribuciones

Jacobian usa Python 3.12, uv y un pequeño Makefile:

make setup
make test-math
make check

Lee CONTRIBUTING.md antes de cambiar código. Allí se documentan los comandos de test enfocados, las puntos de verificación, la ubicación de la documentación y las expectativas para las pull requests.

Licencia

MIT

Available Tools

2 tools
math.findSearch installed Jacobian math toolsA
Read-onlyIdempotent

Find or inspect public Jacobian MCP operations.

Forms:

  • query: describe one local mathematical need in ordinary language. namespace, limit, cursor, and search_mode are optional search controls. Preserve established mathematical names from the task, the supplied objects and constraints, the requested computation or decision, the full scalar, batch, or exhaustive scope, and whether the requested result is a value, witness, certificate, obstruction, profile, or complete enumeration. Do not replace a supplied named property only with its expanded definition, translate the need into catalog tags, or submit the surrounding proof goal.

  • operation_id: pass one exact operation ID to receive its authoritative input and output schemas, operator-authored examples, and current optional backend availability. Matches expose static runtime_requirements; inspection checks these runtimes in the server environment.

For matching, use namespace only when the primary operation-ID namespace is already known with high confidence. Matching returns 10 candidates by default; request up to 20 when a wider first page is useful. Follow next_cursor with the same query, namespace, and search_mode to continue; the limit may change. Ordered matches are deterministic retrieval candidates, not applicability claims; inspect a promising operation before math.run. Read operation://catalog only when the complete bulk catalog is genuinely needed.

An unknown operation ID returns kind: "error" with error.code: "UNKNOWN_OPERATION"; inspect kind even when MCP isError is false. Search with query to find an installed operation, then inspect its exact ID. Zero matches is a successful search.

Examples:

  • {"query":"exact determinant of a rational matrix","namespace":"matrix","limit":3}

  • {"operation_id":"polynomial.compute.gcd"}

Inputs: limit, query, cursor, namespace, +2 more. Returns: Closed discriminated output returned directly through MCP SDK 2.0.

math.runRun one installed Jacobian math toolA
Read-only

Run one installed math tool by ID with its typed payload. A successful call returns the operation-owned canonical mathematical value in output; a later inspected operation may accept that complete value unchanged. Read its fields to determine what the calculation established. MCP reports malformed payloads, unknown IDs, and host failures as tool errors, not as mathematical results. If the payload shape is unknown, inspect the exact operation with math.find. When it publishes an examples item, copy and adapt that item's input object as the payload; otherwise, form the payload from the input schema and its field descriptions. Do not call math.run with an empty payload merely to discover required fields; inspection is authoritative.

Timeout, incomplete search, and missing witnesses appear only in the concrete domain result that owns them; none is a mathematical conclusion by itself.

Examples:

  • {"operation_id":"integer.compute.extended_gcd","payload":{"left":"84","right":"30"}}

Inputs: payload (required), operation_id (required). Returns: The final transport envelope around one direct mathematical result.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.8/5.0

    Scored across 2 tools

    Disambiguation5/5

    math.find is clearly for discovery and inspection of operations, while math.run is clearly for executing a chosen operation. Their purposes do not overlap and the descriptions consistently direct users to inspect before running.

    Naming Consistency5/5

    Both tools follow the same math.<verb> pattern with lowercase snake_case verbs. The naming is predictable and consistent across the set.

    Tool Count4/5

    Two tools are sufficient for a dispatcher-style math catalog: one to find/inspect operations and one to run them. It is slightly below the typical 3-15 range, but the minimal surface is justified by the server's purpose.

    Completeness4/5

    The set covers the core lifecycle: search, inspect schemas/examples, and execute an operation by ID. Minor gaps exist for batch execution, composition, or direct catalog listing, but these are workable through repeated calls.

    Maintenance

    ActivityActive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers