Permite que los asistentes de IA realicen optimización de corte para paneles 2D, barras 1D, madera y nesting de formas irregulares (true-shape) a través de la API de CutOptim.
También conocido como cutoptim/engine-mcp, engine-mcp, @cutoptim/mcp
- Stars
- 0
- Herramientas
- 6
- Descargas, 30 días
- 381
- Última versión
- 0.1.2
- Último commit
- 10 nov 2026
- Licencia
- MIT
¿Qué es CutOptim Engine MCP?
CutOptim Engine es un MCP server. Permite que los asistentes de IA realicen optimización de corte para paneles 2D, barras 1D, madera y nesting de formas irregulares (true-shape) a través de la API de CutOptim. Expone 6 herramientas, como optimize_2d, optimize_1d, optimize_wood.
Resumen generado a partir del README del proyecto
Acerca del MCP server de CutOptim Engine
CutOptim Engine proporciona capacidades especializadas de optimización de corte para asistentes de IA a través del Model Context Protocol. Permite a los usuarios calcular diseños eficientes para diversos materiales, incluyendo paneles 2D, barras 1D, madera y nesting de formas irregulares para piezas de polígonos libres. Los desarrolladores pueden integrar estas capacidades en clientes como Claude Desktop, Cursor, VS Code o Claude Code.
Los usuarios pueden conectarse mediante una configuración alojada apuntando su cliente al endpoint de la API de CutOptim con un Bearer token, o ejecutarlo localmente usando npx. El servidor requiere una CUTOPTIM_API_KEY para acceder a las herramientas de optimización, aunque las herramientas de validación siguen siendo gratuitas sin ella. El sistema incluye herramientas específicas como optimize_2d, optimize_1d, optimize_wood y optimize_nest para manejar diferentes geometrías de materiales. También proporciona las herramientas get_job y get_usage para gestionar tareas asíncronas y monitorear las cuotas mensuales.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar CutOptim Engine MCP
Formatos verificados el 10 nov 2026Instalar CutOptim Engine MCP en Claude Code
$ claude mcp add --env CUTOPTIM_API_KEY=<YOUR_CUTOPTIM_API_KEY> engine-mcp -- npx -y @cutoptim/mcpInstalar CutOptim Engine MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"engine-mcp": {
"command": "npx",
"args": [
"-y",
"@cutoptim/mcp"
],
"env": {
"CUTOPTIM_API_KEY": "<YOUR_CUTOPTIM_API_KEY>"
}
}
}
}Instalar CutOptim Engine MCP en VS Code
.vscode/mcp.json
{
"servers": {
"engine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cutoptim/mcp"
],
"env": {
"CUTOPTIM_API_KEY": "<YOUR_CUTOPTIM_API_KEY>"
}
}
}
}Instalar CutOptim Engine MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"engine-mcp": {
"command": "npx",
"args": [
"-y",
"@cutoptim/mcp"
],
"env": {
"CUTOPTIM_API_KEY": "<YOUR_CUTOPTIM_API_KEY>"
}
}
}
}Instalar CutOptim Engine MCP en Codex
~/.codex/config.toml
[mcp_servers.engine-mcp] command = "npx" args = ["-y", "@cutoptim/mcp"] [mcp_servers.engine-mcp.env] CUTOPTIM_API_KEY = "<YOUR_CUTOPTIM_API_KEY>"
Instalar CutOptim Engine MCP en Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"engine-mcp": {
"command": "npx",
"args": [
"-y",
"@cutoptim/mcp"
],
"env": {
"CUTOPTIM_API_KEY": "<YOUR_CUTOPTIM_API_KEY>"
}
}
}
}Herramientas de CutOptim Engine MCP 6
Detectado desde el READMEoptimize_2doptimize_1doptimize_woodoptimize_nestget_jobget_usage
| optimize_2d | — | |
| optimize_1d | — | |
| optimize_wood | — | |
| optimize_nest | — | |
| get_job | — | |
| get_usage | — |
Configuración
CUTOPTIM_API_KEYSecretoYour CutOptim API key (co_live_…, co_test_…, or the public demo key). Not needed for validate_*.
| Nombre | Descripción | Tipo |
|---|---|---|
| CUTOPTIM_API_KEY | Your CutOptim API key (co_live_…, co_test_…, or the public demo key). Not needed for validate_*. | Secreto |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSAprobado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- Sin avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en GitHubTwo ways to connect
Hosted (no install) — point your MCP client at https://api.cutoptim.com/mcp with the header
Authorization: Bearer <your API key>. Configurations for Claude Code, Cursor, VS Code and Claude Desktop are in the
MCP guide.
Local (this package, stdio) — runs on your machine and calls the same API with your key:
{
"mcpServers": {
"cutoptim": {
"command": "npx",
"args": ["-y", "@cutoptim/mcp"],
"env": { "CUTOPTIM_API_KEY": "co_test_YOUR_KEY" }
}
}
}
Claude Code: claude mcp add cutoptim --env CUTOPTIM_API_KEY=co_test_YOUR_KEY -- npx -y @cutoptim/mcp
| Variable | Meaning |
|---|---|
CUTOPTIM_API_KEY |
your key: co_live_…, co_test_… (never billed) or the public demo key. Without one, only the validate_* tools work. |
CUTOPTIM_BASE_URL |
default https://api.cutoptim.com |
Node 18 or newer.
Tools
| Tool | What it does | Cost |
|---|---|---|
optimize_2d |
rectangular parts from sheets: layout, cut plan, yield | one API call |
optimize_1d |
lengths from bars, tubes, profiles | one API call |
optimize_wood |
timber parts by cross-section | one API call |
optimize_nest |
free-form polygon parts on sheets | one API call |
validate_2d · validate_1d · validate_wood · validate_nest |
check a request without solving it | free |
get_job |
read an async engine: "max" job |
free |
get_usage |
calls used and left this month | free |
The arguments of each tool are exactly the request body of its endpoint — the schemas are generated from the
OpenAPI document. Every result carries a short summary for the assistant
and the API's JSON answer as structuredContent.
Quota and billing
One tool call is one Engine API call: the same key, quota, rate limits and billing as calling the REST API yourself.
The client sends an Idempotency-Key with every optimize call, so its own retries are never charged twice.
License and support
MIT. This repository is published from the CutOptim monorepo; report a bug in Issues or write to support@cutoptim.com.
Preguntas sobre CutOptim Engine MCP
¿Cómo agrego CutOptim Engine MCP a Claude Code?
Ejecuta claude mcp add --env CUTOPTIM_API_KEY=<YOUR_CUTOPTIM_API_KEY> engine-mcp -- npx -y @cutoptim/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego CutOptim Engine MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona CutOptim Engine MCP?
Expone 6 herramientas, incluidas optimize_2d, optimize_1d, optimize_wood, optimize_nest, get_job.
¿Cómo puedo conectarme al MCP server de CutOptim?
Puedes conectarte mediante una versión alojada apuntando tu cliente a la URL de la API con un Bearer token, o ejecutarlo localmente usando npx con tu API key.
¿Hay herramientas gratuitas disponibles?
Sí, las herramientas de validación, la lectura de trabajos asíncronos y la consulta de uso son gratuitas.
¿Cómo funciona la facturación de las llamadas a las herramientas?
Cada llamada a una herramienta de optimización cuenta como una llamada a la API de Engine, siguiendo las mismas reglas de cuota y facturación que la API REST.