터미널에서 사용할 수 있는 자작 MCP + AI Assistant + Workflow 툴 Humble AI CLI 를 소개해 보려고 합니다. ^^

🧩 Humble AI CLI란?

로컬 환경에서 편하게 AI Agent를 실행할 수 있는 CLI 도구입니다.
OpenAI & Ollama API를 모두 지원하고,
MCP Server 호출 및 Markdown 기반 Workflow 자동화 기능을 제공합니다.

🏁 주요 기능 한 줄 요약

📥 다운로드

GitHub Release에서 OS별 바이너리 다운로드
➡️ (Windows / Linux, amd64 & arm64 지원)

🔗 https://github.com/gamzabox/humble-ai-cli/releases

다운로드 받은 humble-ai-cli 를 실행하면 됩니다!

⚙️ 기본 설정

아래 경로의 설정 파일에 사용할 모델 정보를 등록하세요.
$HOME/.humble-ai-cli/config.json :

[code=html]{

"models": [

{

"name": "gpt-5.1",

"provider": "openai",

"apiKey": "sk-...",

"active": true

},

{

"name": "qwen3:30b-a3b-instruct-2507-q4_K_M",

"provider": "ollama",

"baseUrl": "ollama host and port"

}

],

"ollamaContextChunkSize": 0,

"contextRetentionTurns": 5,

"ollamaNumCtx": 50000,

"logLevel": "info",

"toolCallMode": "manual"

}[/code]

주의: Ollama 사용시 ollamaNumCtx 값을 크게 잡아 줘야 MCP 호출이 제대로 동작합니다.

📝 추천 모델

🧠 MCP Server 연결

$HOME/.humble-ai-cli/mcp-servers.json 에 추가:

[code=html]{

"mcpServers": {

"calculator": {

"enabled": true,

"command": "npx",

"args": ["-y", "argument"],

"env": {

"API_TOKEN": "secret"

},

"type": "stdio"

}

}

}[/code]

Stdio / SSE / Streamable-HTTP 모두 사용 가능!

🔁 Workflow 기능 (⭐특히 강력!)

반복 작업을 Markdown 파일 하나로 자동화할 수 있어요.

실행 방법:

humble-ai-cli exec your_workflow.md

샘플 그대로 가져다 수정해서 쓰세요 👇
🔗 https://github.com/gamzabox/humble-ai-cli/blob/main/WORKFLOW.sample.md

📚 더 자세한 정보는