EJClaw/.claude/skills/add-ollama-tool/SKILL.md

name, description

name	description
add-ollama-tool	Add an Ollama MCP tool to the current host-process Claude runner.

Add Ollama Tool

현재 구조에서는 컨테이너를 건드리지 않습니다. Ollama 연동은 호스트에서 실행되는 Claude 러너에 MCP를 추가하는 방식으로 넣습니다.

전제 조건

ollama list

• Ollama가 설치되어 있어야 합니다.
• 최소 한 개 이상의 모델이 있어야 합니다.

권장 예시:

ollama pull gemma3:1b
ollama pull llama3.2

수정 지점

1. 환경 변수 전달

src/agent-runner.ts

• .env에서 OLLAMA_HOST를 읽도록 readEnvFile([...]) 목록에 추가합니다.
• Claude 러너 child env에 OLLAMA_HOST를 명시적으로 넣습니다.

기본값을 쓰면 생략 가능하지만, 원격 Ollama나 다른 포트를 쓸 때는 필요합니다.

2. MCP 서버 추가

runners/agent-runner/src/index.ts

• 호스트에서 동작하는 stdio MCP 서버 파일을 추가합니다.
  • 예: runners/agent-runner/src/ollama-mcp-stdio.ts
• query({ options: { mcpServers, allowedTools } }) 쪽에 Ollama 서버를 등록합니다.
• allowedTools에 mcp__ollama__* 또는 실제 툴 prefix를 추가합니다.

핵심은 두 가지입니다.

• Claude가 Ollama를 CLI가 아니라 MCP 도구로 보게 만들 것
• 툴 이름이 allowedTools에 포함될 것

3. 프롬프트 문서화

groups/global/CLAUDE.md 또는 대상 그룹의 CLAUDE.md

• 언제 Ollama를 쓰는지
• 어떤 모델을 우선 쓰는지
• 빠른 요약/분류/초안 작업에 먼저 쓰도록 할지

이 부분을 적어두지 않으면 에이전트가 도구를 잘 안 고릅니다.

4. 빌드와 검증

npm run build:runners
npm run build
npm run setup -- --step service

디스코드에서 테스트:

ollama 도구를 써서 이 문단을 3줄로 요약해줘

문제 확인

에이전트가 ollama CLI를 직접 치려고 함

• MCP 서버 등록이 빠졌거나
• allowedTools에 툴 prefix가 없거나
• 프롬프트 문서에 사용 규칙이 없습니다

연결 실패

• ollama list가 호스트에서 되는지 먼저 확인합니다
• 원격 호스트면 .env의 OLLAMA_HOST를 확인합니다