35ba7cb5ba
- Source: setup/service.ts, runners.ts, agent-runner.ts error messages - Scripts: restart-stack.sh, run-migrations.ts → bun - Bootstrap: setup.sh check_node→check_bun, npm install→bun install - Docs: CLAUDE.md, README.md, all SKILL.md files - Tests: service.test.ts, restart-stack.test.ts expectations updated
85 lines
2.2 KiB
Markdown
85 lines
2.2 KiB
Markdown
---
|
|
name: add-ollama-tool
|
|
description: Add an Ollama MCP tool to the current host-process Claude runner.
|
|
---
|
|
|
|
# Add Ollama Tool
|
|
|
|
현재 구조에서는 컨테이너를 건드리지 않습니다. Ollama 연동은 호스트에서 실행되는 Claude 러너에 MCP를 추가하는 방식으로 넣습니다.
|
|
|
|
## 전제 조건
|
|
|
|
```bash
|
|
ollama list
|
|
```
|
|
|
|
- Ollama가 설치되어 있어야 합니다.
|
|
- 최소 한 개 이상의 모델이 있어야 합니다.
|
|
|
|
권장 예시:
|
|
|
|
```bash
|
|
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. 빌드와 검증
|
|
|
|
```bash
|
|
bun run build:runners
|
|
bun run build
|
|
bun run setup -- --step service
|
|
```
|
|
|
|
디스코드에서 테스트:
|
|
|
|
> `ollama 도구를 써서 이 문단을 3줄로 요약해줘`
|
|
|
|
## 문제 확인
|
|
|
|
### 에이전트가 `ollama` CLI를 직접 치려고 함
|
|
|
|
- MCP 서버 등록이 빠졌거나
|
|
- `allowedTools`에 툴 prefix가 없거나
|
|
- 프롬프트 문서에 사용 규칙이 없습니다
|
|
|
|
### 연결 실패
|
|
|
|
- `ollama list`가 호스트에서 되는지 먼저 확인합니다
|
|
- 원격 호스트면 `.env`의 `OLLAMA_HOST`를 확인합니다
|