피드로 돌아가기
I Turned helix-agent into helix-agents: One MCP Server for Ollama, Codex, and OpenAI-Compatible Models
Dev.toDev.to
AI/ML

단일 MCP 서버로 Ollama, Codex, OpenAI 모델 통합 관리 가능함

I Turned helix-agent into helix-agents: One MCP Server for Ollama, Codex, and OpenAI-Compatible Models

Tsunamayo2026년 4월 1일2intermediate

Context

Claude Code 사용 시 로컬 모델, 강력한 코딩 에이전트, API 모델 등 작업 특성에 따라 다른 provider가 필요한 상황이 발생함. 기존 MCP 서버들은 단일 provider와 단일 실행 스타일만 지원하여 유연성 제약이 있었음.

Technical Solution

  • helix-agents: Ollama, Codex, OpenAI-compatible provider를 단일 MCP 서버로 통합함
  • ReAct loop: Ollama와 OpenAI-compatible를 위한 내장 반복 추론 루프 구현함
  • Codex-backed delegation: 코드 중심 repo 작업 전용 자율 실행 경로 제공함
  • Background agent: spawn_agent, send_agent_input, wait_agent, list_agents, close_agent 도구로 백그라운드 작업 관리함
  • Claude Code config: mcpServers 설정에 uv run 명령으로 서버 등록함

Impact

세 가지 다른 MCP 서버 운영을 단일 런타임으로 대체하여 설정 및 관리 복잡도 감소함.

Key Takeaway

Provider별 강점을 활용하려면 단일 인터페이스로 추상화하는 것이 유지보수와 확장성 측면에서 효과적임.


Claude Code에서 로컬 추론은 Ollama, 코드 구현은 Codex, 호스팅 채팅은 OpenAI-compatible로 구분하여 작업할 때 helix-agents를 통해 하나의 MCP 서버 설정만으로 각 provider를 전환しながら 활용할 수 있음. background agent 기능으로 장기 실행 작업을 별도로 관리하고 결과를 취합하는 워크플로우 구현이 가능함.

원문 읽기