CutOptim API를 통해 AI 어시스턴트가 2D 패널, 1D 바, 목재 및 트루셰이프(true-shape) 네스팅 절단 최적화를 수행할 수 있도록 지원합니다.
다른 이름 cutoptim/engine-mcp, engine-mcp, @cutoptim/mcp
- 스타
- 0
- Tools
- 6
- 다운로드, 30일
- 391
- 최신 버전
- 0.1.2
- 마지막 커밋
- 2026년 11월 10일
- 라이선스
- MIT
CutOptim Engine MCP란?
CutOptim Engine은(는) MCP server입니다. CutOptim API를 통해 AI 어시스턴트가 2D 패널, 1D 바, 목재 및 트루셰이프(true-shape) 네스팅 절단 최적화를 수행할 수 있도록 지원합니다. 6개 도구를 제공합니다. 예: optimize_2d, optimize_1d, optimize_wood.
프로젝트 README에서 생성된 요약
CutOptim Engine MCP server 정보
CutOptim Engine은 Model Context Protocol을 통해 AI 어시스턴트에게 특화된 절단 최적화 기능을 제공합니다. 사용자는 2D 패널, 1D 바, 목재 및 자유 형태의 다각형 부품을 위한 트루셰이프 네스팅을 포함한 다양한 자재의 효율적인 레이아웃을 계산할 수 있습니다. 개발자는 이러한 기능을 Claude Desktop, Cursor, VS Code 또는 Claude Code와 같은 클라이언트에 통합할 수 있습니다.
사용자는 클라이언트를 Bearer 토큰과 함께 CutOptim API 엔드포인트로 지정하여 호스팅 설정으로 연결하거나 npx를 사용하여 로컬에서 실행할 수 있습니다. 최적화 도구에 액세스하려면 CUTOPTIM_API_KEY가 필요하지만, 검증 도구는 키 없이도 무료로 사용할 수 있습니다. 시스템에는 다양한 자재 형상을 처리하기 위한 optimize_2d, optimize_1d, optimize_wood, optimize_nest와 같은 특정 도구가 포함되어 있습니다. 또한 비동기 작업을 관리하고 월간 할당량을 모니터링할 수 있는 get_job 및 get_usage 도구도 제공합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
CutOptim Engine MCP 설치 방법
형식 확인: 2026년 11월 10일Claude Code에 CutOptim Engine MCP 설치
$ claude mcp add --env CUTOPTIM_API_KEY=<YOUR_CUTOPTIM_API_KEY> engine-mcp -- npx -y @cutoptim/mcpCursor에 CutOptim Engine MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"engine-mcp": {
"command": "npx",
"args": [
"-y",
"@cutoptim/mcp"
],
"env": {
"CUTOPTIM_API_KEY": "<YOUR_CUTOPTIM_API_KEY>"
}
}
}
}VS Code에 CutOptim Engine MCP 설치
.vscode/mcp.json
{
"servers": {
"engine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cutoptim/mcp"
],
"env": {
"CUTOPTIM_API_KEY": "<YOUR_CUTOPTIM_API_KEY>"
}
}
}
}Claude Desktop에 CutOptim Engine MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"engine-mcp": {
"command": "npx",
"args": [
"-y",
"@cutoptim/mcp"
],
"env": {
"CUTOPTIM_API_KEY": "<YOUR_CUTOPTIM_API_KEY>"
}
}
}
}Codex에 CutOptim Engine MCP 설치
~/.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>"
Gemini CLI에 CutOptim Engine MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"engine-mcp": {
"command": "npx",
"args": [
"-y",
"@cutoptim/mcp"
],
"env": {
"CUTOPTIM_API_KEY": "<YOUR_CUTOPTIM_API_KEY>"
}
}
}
}CutOptim Engine MCP 도구 6
README에서 감지됨optimize_2doptimize_1doptimize_woodoptimize_nestget_jobget_usage
| optimize_2d | — | |
| optimize_1d | — | |
| optimize_wood | — | |
| optimize_nest | — | |
| get_job | — | |
| get_usage | — |
구성
CUTOPTIM_API_KEY비밀Your CutOptim API key (co_live_…, co_test_…, or the public demo key). Not needed for validate_*.
| 이름 | 설명 | 유형 |
|---|---|---|
| CUTOPTIM_API_KEY | Your CutOptim API key (co_live_…, co_test_…, or the public demo key). Not needed for validate_*. | 비밀 |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지와 의존성에 심각한 보안 권고 없음통과
README
GitHub에서 보기Two 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.
CutOptim Engine MCP 질문
CutOptim Engine MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env CUTOPTIM_API_KEY=<YOUR_CUTOPTIM_API_KEY> engine-mcp -- npx -y @cutoptim/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
CutOptim Engine MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
CutOptim Engine MCP는 어떤 도구를 제공하나요?
6개 도구를 제공합니다. 예: optimize_2d, optimize_1d, optimize_wood, optimize_nest, get_job.
CutOptim MCP server에 어떻게 연결하나요?
클라이언트에서 Bearer 토큰과 함께 API URL을 지정하여 호스팅 버전에 연결하거나, npx를 사용하여 로컬에서 API 키로 실행할 수 있습니다.
무료로 사용할 수 있는 도구가 있나요?
네, 검증 도구, 비동기 작업 읽기 및 사용량 확인 기능은 무료입니다.
도구 호출에 대한 과금 방식은 어떻게 되나요?
각 최적화 도구 호출은 Engine API 호출 1회로 계산되며, REST API와 동일한 할당량 및 과금 규칙이 적용됩니다.