mcp-ollama

API 기반 오케스트레이터의 비용을 절감하기 위해 로컬 Ollama 모델을 래핑하는 MCP 서버입니다.

로컬 모델에 작업을 전달하는 9개의 도구를 제공합니다(텍스트 생성, 요약, 코드 작업, 기계적 변환, 커밋/PR/변경 로그 초안 작성). 오케스트레이터가 로컬로 라우팅할 작업을 결정하며, 이 서버는 해당 라우팅을 수행합니다.

• 전송 방식: stdio

• 런타임: Node 18+

• 기본 모델: hermes3:8b (OLLAMA_MODEL을 통해 재정의 가능)

• Ollama 호스트: http://localhost:11434 (OLLAMA_HOST를 통해 재정의 가능)

• 라이선스: Apache-2.0

설치

npm install
npm run build

또한 최소 하나 이상의 모델이 다운로드된 실행 중인 Ollama 인스턴스가 필요합니다:

ollama pull hermes3:8b
ollama pull qwen2.5-coder:32b  # optional, for local_code

실행 (stdio)

node dist/index.js

Claude Code 설정

claude mcp add --transport stdio ollama -- node /absolute/path/to/mcp-ollama/dist/index.js

또는 ~/.claude/settings.json 파일에서 설정:

{
  "mcpServers": {
    "ollama": {
      "transport": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mcp-ollama/dist/index.js"],
      "env": {
        "OLLAMA_HOST": "http://localhost:11434",
        "OLLAMA_MODEL": "hermes3:8b"
      }
    }
  }
}

도구

전체 도구 스키마는 MCP 인트로스펙션을 통해 노출됩니다.

환경 변수

목적

토큰 단위로 비용이 청구되는 오케스트레이터(Claude Code, Cursor, Anthropic API)는 모든 분류, 독스트링, 커밋 메시지에 대해 비용을 지불합니다. 이러한 작업 대부분은 Opus나 GPT-5가 필요하지 않습니다. 같은 머신에서 Ollama로 라우팅하면 동일한 작업을 무료로 더 빠르게 수행할 수 있습니다. mcp-ollama는 그 라우팅 인터페이스 역할을 합니다.

ALTER의 일부

mcp-ollama는 AI 경제를 위한 신원 인프라의 일환으로 ALTER에서 유지 관리합니다. ALTER 신원 MCP 서버는 mcp.truealter.com에서 호스팅됩니다.