개요
itsmostafa/system-one-connector는
evaluate라는 단일 Go 정적 바이너리로 구현된 MCP 커넥터다. Claude Code, Claude
Desktop, Codex, Hermes, pi를 TypeSafe Jev(및 오픈 System One
모델인 CLM, Laya)에 연결해, 에이전트가 산문 대신 확률이 붙은 typed 답(noul/choice/
score)을 받을 수 있게 한다.
한 줄 핵심: 특정 provider에 종속되지 않는 범용 System One MCP 게이트웨이 — TypeSafe API·OpenRouter Decisions·자체 호스팅 서버(CLM, Laya) 중 어디로 보낼지를 환경변수로만 바꾸고, MCP 툴 자체는 5개 클라이언트에 동일하게 노출한다.
배경
문제의식: 빠른 판단이 필요한 에이전트가 LLM에게 물으면 문장을 돌려받고, 그
문장에서 다시 의미를 추측해야 한다 — “꽤 급한 것 같다”는 분기(if)에 쓸 수 없고,
확신에 찬 답과 동전 던지기를 구분할 수 없다. Jev 같은 System One 모델은 텍스트
생성 대신 질문/옵션을 형식화해서 보내면 각 답에 확률을 붙여 반환하도록 만들어졌다.
system-one-connector는 이 모델들을 5개의 에이전트 클라이언트에 원클릭으로 연결하는
“배관” 역할만 한다.
설치 & 연결
curl -fsSL https://raw.githubusercontent.com/itsmostafa/system-one-connector/main/install.sh | sh
# 또는: go install github.com/itsmostafa/system-one-connector/cmd/evaluate@latest
TYPESAFE_API_KEY=your-key evaluate setup mcp # Claude Code/Desktop, Codex, Hermes에 등록
evaluate setup pi # pi는 MCP 클라이언트가 아니라 네이티브 확장 파일 생성설치 스크립트는 릴리스 아카이브를 SHA-256 체크섬으로 검증한 뒤 ~/.local/bin
(또는 EVALUATE_INSTALL_DIR)에 설치한다. evaluate update가 같은 방식으로
바이너리를 교체하며, 서버는 신규 릴리스가 있으면 시작 시 에이전트에게 알려준다.
API 라우트
| 변수 | 라우트 | 기본 모델 |
|---|---|---|
TYPESAFE_API_KEY | TypeSafe API POST {TYPESAFE_BASE_URL}/v1/systemone (기본 호스트 api.typesafe.ai) | jev-latest (또는 TYPESAFE_MODEL) |
OPENROUTER_API_KEY | OpenRouter Decisions 엔드포인트(/api/alpha/, 아직 알파) | ~typesafe/jev-latest |
둘 다 설정되면 TYPESAFE_API_KEY가 우선한다. TYPESAFE_BASE_URL로 프록시·자체
게이트웨이·로컬 서버를 가리킬 수 있어, POST /v1/systemone을 구현하는 어떤
서버(Laya 로컬 서빙 등)에도 연결된다. CLM-v0.1-8B(Contrastive-LM,
GPU 필요)도 같은 커스텀 호스트 경로로 붙는다 — clm-serve가 미지의 모델명을
거부하므로 TYPESAFE_MODEL=clm-latest 지정이 필수. CLM은 state를 프로즈로
임베드하고 2048 토큰에서 자르므로, Jev 대상으로 쓰인 가이드 텍스트가 그대로
맞지 않을 수 있다.
MCP 툴 evaluate
노출하는 MCP 툴은 동명의 evaluate 하나뿐이다.
- 입력:
state(판단 대상 — 관찰된 증거와 판단 배경만, 결론은 넣지 말 것),questions(id→{type, instructions, criteria?}),items(최대 500개 레코드를 한 번에 각각 판정, 동시 8요청),model,include_item_usage. - 질문 타입:
noul(yes/no 확률),choice(최대 255옵션 중 1개+확률 분포),score(순서 있는 레벨 위 확률가중 위치, 0-인덱스).noul/choice는min_confidence로 낮은 신뢰도 답을"uncertain": true/"__uncertain__"로 처리하게 할 수 있다. - items 모드는 TypeSafe API 자체엔 없는 커넥터 고유 기능 — 요청당 최대
500 레코드, 응답은
{results, errors, meta}이며 개별 항목 실패해도 나머지는 완료된다. 배치 응답 전체 16MiB 제한. - 제한: 요청 타임아웃 60초, HTTP 429/529에 최대 3회 지수 백오프 재시도, 응답 16MiB 초과 시 거부, non-JSON 성공 바디 거부. 도구는 read-only — 로컬 머신을 전혀 바꾸지 않는다.
- 클라이언트 연결 시 서버가 MCP server instructions로 “좁은 질문·JSON state·no-match 옵션·증거 우선” 가이드를 전송해, 별도 프롬프트 없이도 에이전트가 질문을 잘 구성하게 유도한다.
한계
- 외부 의존성: TypeSafe 유료 API 키(또는 OpenRouter 계정)가 기본 경로 —
자체 호스팅 경로(CLM/Laya)를 쓰지 않으면 벤더 종속.
OpenRouter Decisions 엔드포인트는 아직 알파(
/api/alpha/) 경로라 바뀔 수 있음. evaluate setup mcp를 재실행하면 각 클라이언트의 기존evaluate항목을 통째로 덮어써서, 수동으로 바꾼 설정(예: Hermes 툴 선택)이 리셋된다.- CLM 경로는 Jev용으로 쓰인 가이드 문구·지연시간 수치가 그대로 적용되지 않을 수 있다는 것을 문서가 명시.
관계
- 기반 모델/프로토콜: TypeSafe Jev —
/v1/systemonewire API. 같은 프로토콜을 구현한 오픈소스 대체 서버는 2026-09-27-github-razorback16-openjev(DiffusionGemma 기반), interfaze-ai/lev(Qwen3.5-4B LoRA) 참조. 이 커넥터가 직접 지원하는 오픈 모델은 CLM(2026-09-27-github-razorback16-openjev과는 별도)과 2026-09-27-laya-mlx의 원본인 Laya. - 같은 Jev 판단 위임 계열: fast-jev-compaction(Claude Code 압축을 Jev 판정으로 대체), jev-ultrafast(브라우저 에이전트 operation/target 결정을 Jev에 위임) — 이 커넥터는 그 반대로, 모델이 아니라 연결 배관만 제공한다는 점에서 구분됨.
- 호스트 플랫폼: moc-claude-code (
evaluate setup mcp가 Claude Code/Desktop에 등록), moc-ai-models (System One 결정 모델 생태계 인프라). - 같은 목적의 다른 MCP 서버: 2026-09-27-jev-mcp — Jev를 단일 범용
evaluate툴이 아니라 verify·screen·classify·decide·review·gate 등 11개의 목적별 MCP 도구로 나눠 노출한다는 점에서 접근이 다르다.
참고
- 저장소: https://github.com/itsmostafa/system-one-connector
- 라이선스: MIT · 언어: Go 80.8k · TypeScript 9.6k · Shell 1.8k
- 별 318 · 포크 35 · 오픈 이슈 2 · 최신 릴리스 v0.4.7(2026-09-27)
- 생성: 2026-09-17, 최근 푸시: 2026-09-27
- 소유자: itsmostafa