Cómo conectarse a Wolfram Local MCP

Esta guía explica cómo conectar un Wolfram Engine local, como Wolfram|One o Mathematica, con un LLM mediante Wolfram Local MCP. A partir de la versión 15, el paclet que potencia esta funcionalidad está incorporado en el producto.

Para más información sobre cómo conectarse a Wolfram Cloud MCP, diríjase aquí.

Tabla de contenido

• Clientes de chat (Claude Desktop, etc.)
  • Servidor recomendado
  • Instalación
  • Herramientas disponibles
  • Ejemplos de casos de uso
  • Instrucciones persistentes
  • Sugerencias para mejores resultados
• Aplicaciones de programación con IA (Claude Code, Cursor, VS Code, etc.)
  • Servidor recomendado
  • Instalación
  • Cómo configurar la guía de IA mediante AGENTS.md
  • Buenas prácticas
  • Consideraciones de seguridad
• Resolución de problemas

Clientes de chat

Servidor recomendado

Para chat de uso general, use el servidor Wolfram (el predeterminado). Combina ejecución de código con computación en lenguaje natural.

Instalación

Claude Desktop

Abra una sesión de Wolfram Language y ejecute:

PacletSymbol["Wolfram/AgentTools",
"WolframAgentToolsInstallMCPServer"]["ClaudeDesktop"]

Luego de la instalación, reinicie Claude Desktop por completo para cargar las nuevas herramientas.

Otros clientes de chat

Para otros clientes compatibles con MCP, genere la configuración JSON sin procesar y adáptela manualmente:

MCPServerObject["Wolfram"]["JSONConfiguration"]

Cómo verificar la instalación

Luego de reiniciar, pregunte a su asistente de IA:

"¿Cuál es la integral de sin(x)cos(x)?"

Si la IA usa herramientas de Wolfram para calcular la respuesta, la instalación ha sido correcta.

Herramientas disponibles

El servidor de Wolfram proporciona múltiples herramientas. La IA selecciona la herramienta adecuada de manera automática según su solicitud, sin necesidad de especificar qué herramienta usar.

Ejemplos de casos de uso

Matemáticas y computación

• "Resuelve la ecuación x³ - 6x² + 11x - 6 = 0."
• "Encuentra los valores propios de la matriz {{1,2},{3,4}}."
• "Calcula la serie de Taylor de e^x alrededor de x=0 hasta el orden 5."
• "¿Cuál es la derivada de log(sin(x))?"

Datos y hechos

• "¿Cuál es la población de Francia?"
• "¿Qué tan lejos está Marte de la Tierra en este instante?"
• "¿Cuál es el punto de ebullición del etanol a 0.5 atm?"
• "Compara el PIB de Japón y Alemania durante los últimos 10 años."

Visualización

• "Representa sin(x) and cos(x) de 0 a 2pi."
• "Crea un diagrama de barras que compare la población de las 10 ciudades más grandes de los EE.UU."
• "Muestra una representación 3D de sin(x*y) para x e y de -pi a pi."

Búsqueda en la documentación

• "¿Cómo funciona la función NestList de Wolfram Language?"
• "¿Qué opciones admite ListPlot?"
• "Muéstrame ejemplos del uso de Association con GroupBy."

Asistencia de programación

• "Escribe una función de Wolfram Language que encuentre todos los factores primos de un número."
• "¿Cómo puedo leer un archivo CSV y calcular el promedio de cada columna en Wolfram Language?"
• "Explica lo que hace este código: FoldList[Plus, 0, Range[10]]"

Instrucciones persistentes

Las instrucciones persistentes son texto personalizado que su cliente de chat envía a la IA al inicio de cada conversación, a modo de instrucciones permanentes.

Cómo configurarlas en Claude Desktop

1. Abra Claude Desktop.
2. Diríjase a Configuración (ícono de engranaje).
3. Seleccione la pestaña General.
4. Ingrese sus instrucciones bajo la sección Perfil.
5. Guarde los cambios.

Plantillas listas para su uso

Uso computacional general

Cuando hago preguntas matemáticas o científicas, usa herramientas de Wolfram para calcular respuestas exactas en lugar de aproximar. Muestra el código de Wolfram Language que usaste para que pueda aprender de él.

Para preguntas fácticas (población, distancia, propiedades químicas, etc.), usa Wolfram|Alpha para datos actualizados.

Al producir representaciones gráficas o visualizaciones, usa etiquetas y leyendas claras.

Sobre aprender Wolfram Language

Estoy aprendiendo Wolfram Language. Cuando pregunto cómo hacer algo:

1. Primero usa WolframContext para encontrar funciones y documentación pertinentes.
2. Escribe el código usando WolframLanguageEvaluator y muéstrame el resultado.
3. Explica cada parte del código.
4. Sugiere funciones relacionadas que puedan parecerme útiles.

Utiliza estilo idiomático de Wolfram Language. Usa patrones de programación funcional (Map, Select, Fold, etc.) en lugar de bucles procedimentales cuando sea adecuado.

Investigación y análisis de datos

Uso las herramientas de Wolfram en investigación y análisis de datos. Cuando hago preguntas:

- Usa Wolfram|Alpha para datos y hechos actuales.
- Usa WolframLanguageEvaluator para cálculos, estadísticas y visualizaciones.
- Siempre cita la fuente de datos fácticos (por ejemplo, "Según Wolfram|Alpha...").
- Al crear visualizaciones, expórtalas en alta resolución.

Para análisis estadístico, muestra el código e interpreta los resultados en lenguaje simple. Incluye medidas pertinentes de incertidumbre cuando sea adecuado.

Sugerencias para personalizar

• Sea específico acerca de su campo o disciplina (por ejemplo, "Trabajo en procesamiento de señales").
• Mencione preferencias de salida (por ejemplo, "Muestra siempre las ecuaciones en formato LaTeX").
• Especifique su nivel de experiencia para que las explicaciones se calibren apropiadamente.
• Mantenga las instrucciones concisas, las instrucciones demasiado largas pueden reducir su eficacia

Sugerencias para obtener los mejores resultados

• Sea específico. "Representa la función de Bessel J0 de 0 a 20" funciona mejor que "Muéstrame una función de Bessel."
• Pida explicaciones. "Resuelve esto y explica cada paso" produce respuestas más útiles.
• Itere sobre visualizaciones. Comience con una representación básica, luego refine: "Haz que los ejes sean más grandes y agrega una retícula."
• Combine herramientas. "Busca la fórmula para la radiación de cuerpo negro y luego represéntala para T = 3000K, 5000K, y 7000K" usa tanto la búsqueda en la documentación como la evaluación de código.
• Solicite código. Pregunte "Muéstrame el código de Wolfram Language" para ver lo que la IA ejecuta.

Aplicaciones de programación con IA

Servidor recomendado

Para desarrollo en Wolfram Language, use el servidor WolframLanguage. Este proporciona a la IA la capacidad de:

• Buscar en recursos de Wolfram incluyendo la documentación, repositorio de funciones, repositorio de datos y más.
• Ejecutar código para probar implementaciones y verificar comportamiento.
• Leer y escribir cuadernos (archivos .nb) como Markdown.
• Buscar definiciones de símbolos para comprender el código existente.
• Inspeccionar el código para detectar posibles problemas y cuestiones de estilo.
• Ejecutar pruebas para validar los cambios frente a su conjunto de pruebas.

Instaclación

Todos los métodos de instalación usan la función InstallMCPServer. Abra una sesión de Wolfram Language y ejecute el comando adecuado para su aplicación.

Claude Code

Global ((disponible en todos los proyectos)):

InstallMCPServer["ClaudeCode", "WolframLanguage"]

A nivel de proyectos (disponible solo en un directorio específico):

InstallMCPServer[{"ClaudeCode", "/path/to/project"}, "WolframLanguage"]

Verifique desde la línea de comandos:

claude mcp get WolframLanguage

Cline

InstallMCPServer["Cline", "WolframLanguage"]

Copilot CLI

InstallMCPServer["CopilotCLI", "WolframLanguage"]

Verifique: copilot -i "/mcp show"

Cursor

InstallMCPServer["Cursor", "WolframLanguage"]

Verifique: Configuración → Herramientas & MCP → confirme que "WolframLanguage" aparezca.

Gemini CLI

InstallMCPServer["GeminiCLI", "WolframLanguage"]

Verifique: gemini -i "/mcp"

Google Antigravity

InstallMCPServer["Antigravity", "WolframLanguage"]

Verifique: Vista de editor → ... menú → panel de Agente → Servidores MCP → Gestionar servidores MCP.

OpenAI Codex

InstallMCPServer["Codex", "WolframLanguage"]

Verifique: codex mcp get WolframLanguage

OpenCode

Global

InstallMCPServer["OpenCode", "WolframLanguage"]

A nivel de proyectos

InstallMCPServer[{"OpenCode", "/path/to/project"}, "WolframLanguage"]

Verifique: opencode mcp list

Visual Studio Code

Global

InstallMCPServer["VisualStudioCode", "WolframLanguage"]

A nivel de proyectos

InstallMCPServer[{"VisualStudioCode", "/path/to/project"}, "WolframLanguage"]

Windsurf

InstallMCPServer["Windsurf", "WolframLanguage"]

Zed

InstallMCPServer["Zed", "WolframLanguage"]

Otros clientes

Genere la configuración JSON sin procesar y adáptela manualmente:

MCPServerObject["WolframLanguage"]["JSONConfiguration"]

Cómo verificar la instalación

Luego de instalar, reinicie su herramienta de programación y pregunte a la IA:

"¿A qué herramientas de Wolfram tienes acceso?"

La IA debería listar herramientas como WolframLanguageEvaluator, WolframLanguageContext, TestReport, etc.

Cómo configurar la guía de IA mediante AGENTS.md

Las herramientas de programación de IA inician cada sesión sin memoria de conversaciones anteriores. Un archivo AGENTS.md ubicado en el directorio raíz de su proyecto proporciona a la IA el contexto esencial sobre su base de código, convenciones y cómo utilizar las herramientas de Wolfram Language de manera eficaz.

Nota para Claude Code: Claude Code usa CLAUDE.md en lugar de AGENTS.md. Para proyectos que usen múltiples herramientas de programación de IA, puede colocar @AGENTS.md dentro de su CLAUDE.md para incluir sus contenidos de manera automática o crear CLAUDE.md como un enlace simbólico: ln -s AGENTS.md CLAUDE.md.

Por qué importa

Sin una guía, la IA no sabrá cuándo usar WolframLanguageContext para buscar documentación, puede perderse las convenciones de programación de su proyecto y omitir las pruebas e inspección de código.

Qué incluir

1. Guía de herramientas — Cuándo y cómo usar cada herramienta de Wolfram Language
2. Estructura de proyectos — Estructura de directorios, archivos principales y puntos de entrada
3. Estilo de código — Convenciones de nomenclatura, patrones y enfoque para el manejo de errores
4. Pruebas — Cómo ejecutar las pruebas, dónde se encuentran los archivos de prueba y su formato

Plantilla de AGENTS.md

# AGENTS.md

## Resumen

Breve descripción de la finalidad del proyecto.

## Desarrollo

Siempre usa la herramienta WolframLanguageContext al trabajar con código de Wolfram Language para consultar la documentación y localizar funciones relevantes antes de escribir código.

Cuando realices cambios en el código fuente, escribe y ejecuta pruebas usando la herramienta TestReport y comprueba tu trabajo con la herramienta CodeInspector.

## Estructura del proyecto

 - `Kernel`-Archivos principales del código fuente
   - `MyPaclet.wl`-Punto de entrada
   - `Utilities.wl`-Funciones auxiliares
 - `Tests`-Archivos de prueba (.wlt)
 - `Documentation`-Cuadernos y documentos

## Estilo de código

- Usa `UpperCamelCase` para nombres de funciones públicas
- Usa `lowerCamelCase` para nombres de funciones internas
- Usa `Enclose/Confirm` para el manejo de errores:

{```wl
myFunction[arg_] := Enclose[
  Module[{result},
    result = ConfirmBy[computation[arg], StringQ];
    result
  ]
];
```}
## Escritura de pruebas

Escribe pruebas en este formato:

{```wl
VerificationTest[
  input,
  expected,
  TestID -> "DescriptiveTestID"
]
```}
Los archivos de prueba van en el directorio `Tests/` con una extensión `.wlt`.

## Patrones clave

Describe cualquier patrón, convención o decisión de arquitectura específica del proyecto que la IA deba seguir.

Actualice AGENTS.md cada vez que agregue nuevos archivos o directorios, establezca nuevos patrones programación, descubra casos límite que la IA deba conocer o cambie las estrategias de prueba.

Buenas prácticas

Desarrollo impulsado por pruebas

Las herramientas de programación con IA funcionan particularmente bien con un flujo de trabajo basado en pruebas:

1. Escriba primero las pruebas que describan el comportamiento esperado.
2. Pida a la IA que implemente la función para pasar las pruebas.
3. Ejecute pruebas con TestReport para verificar.
4. Itere hasta que se pasen todas las pruebas.

Use el modo de planificación

Para tareas no triviales, pida a la IA que elabore un plan antes de implementar. Muchas aplicaciones admiten un "modo de planificación" incorporado. Úselo para revisar el enfoque propuesto antes de escribir código.

Gestione el contexto en tareas de larga duración

Las herramientas de programación de IA tienen ventanas de contexto finitas. Para características complejas que abarquen múltiples sesiones, un enfoque de gestión de contexto manual suele ser más eficaz que depender de la compresión automática.

Cuándo usar sesiones estructuradas:

• Características que requieran más de una sesión de implementación
• Trabajos que abarquen múltiples horas o días
• Tareas donde mantener la precisión sea crucial

El flujo de trabajo—mantenga tres documentos de trabajo:

Ejemplo de documento de especificación

# Característica: Importación de CSV mediante validación de esquemas

## Requerimientos
- Analizar archivos CSV y convertirlos en listas de Association
- Admitir especificaciones personalizadas de tipos de columna
- Validar datos con respecto a esquemas proporcionados
- Devolver objetos Failure para datos no válidos

## Diseño de API
CSVImportValidated[archivo, esquema]  
(* devuelve {<|...|>, ...} o Failure *)

## Formato de esquema
<|"Name" →  "String", "Age" →  "Integer", "Score" → "Real"|>

## Casos límite
- Los archivos vacíos devuelven {}
- Las columnas faltantes devuelven Failure["MissingColumn", ...]
- Las incompatibilidades de tipo devuelven Failure["TypeError", ...]

Prompt para cada sesión (prompt.md)

## Contexto

@TODO/CSVImportValidated.md
@Specs/CSVImportValidated.md
@Progress/CSVImportValidated.md

## Instrucciones

1. Selecciona la siguiente tarea incompleta de la lista de tareas.
2. Estudia los requisitos de la especificación para esa tarea.
3. Implementa la tarea.
4. Agrega un informe de progreso a Progress/CSVImportValidated.md.
5. Marca la tarea como completada en TODO/CSVImportValidated.md.
6. Confirma tus cambios.
7. Detente y espera la intervención del usuario.

IMPORTANTE: Completa solo UNA tarea por sesión.

Ejecute cada sesión mediante:

claude "$(cat prompt.md)"

Comience una nueva sesión luego de cada tarea en lugar de continuar la misma conversación. Revise y edite el archivo de progreso manualmente para asegurarse que capture el contexto correcto.

Consideraciones de seguridad

Las herramientas WolframLanguageEvaluator y TestReport ejecutan código arbitrario de Wolfram Language. Esto significa que pueden leer, escribir y eliminar archivos, realizar solicitudes de red, ejecutar comandos del sistema y acceder a variables del entorno.

Configure su aplicación para que solicite aprobación antes que la IA ejecute estas herramientas. La mayoría de aplicaciones de programación con IA admiten permisos basados en aprobación para este fin.

CodeInspector y ReadNotebook lee el contenido de los archivos que se envíen a su proveedor de LLM. Si su proyecto contiene información confidencial, considere requerir aprobación para estas herramientas.

Inyección de prompts

Si su aplicación de programación con IA obtiene contenido de la web o de otras fuentes no confiables, tenga en cuenta que puede haber contenido malicioso que puede hacer que la IA utilice otras herramientas de formas no previstas. Como regla general, si aprueba automáticamente herramientas que leen contenido externo no confiable, requiera aprobación para todas las herramientas que puedan exponer información confidencial.

Resolución de problemas

El servidor no se conecta

• Reinicie por completo su cliente de chat o aplicación de programación luego de la instalación. Cerrar la ventana a menudo solo la minimiza a la bandeja del sistema.
• Consulte la documentación de su cliente para obtener las ubicaciones de los archivos de registro e inspecciónelos en busca de errores.

WolframContext no funciona como se esperaba

Para los mejores resultados, asegúrese de haber actualizado a la versión 15 de Wolfram. En versiones anteriores, WolframContext requería una suscripción aparte para usar la funcionalidad completa. Sin ella, los resultados de Wolfram|Alpha no se incluirán, y la precisión de las búsquedas en la documentación se verá reducida. La versión 15 incluye todo lo necesario.

Tiempos de espera agotados durante la computación

Por defecto, las evaluaciones tienen un límite de tiempo de 60 segundos. Pida a la IA que aumente el tiempo de espera o divida la computación en pasos más pequeños.

El servidor utiliza una versión incorrecta de Wolfram Language

El servidor MCP instalado usa la misma versión de Wolfram Language que la sesión en la que fue instalado. Para usar una versión distinta, instale el servidor MCP desde una sesión que ejecute esa versión o edite manualmente el archivo de configuración para que apunte a otro kernel de Wolfram.

Fuente: Wolfram AgentTools Paclet Repository — © 2026 Wolfram Research