rawveg/ollama-mcp

로컬 LLM 접근으로 AI 비서를 강화하세요

Ollama SDK를 MCP 도구로 제공하여, 로컬 LLM 모델과 Claude Desktop, Cline 같은 MCP 호환 애플리케이션 간의 원활한 통합을 가능하게 하는 MCP(Model Context Protocol) 서버입니다.

기능 • 설치 • 사용 가능한 도구 • 구성 • 재시도 동작 • 개발

---

✨ 특징

• ☁️ Ollama 클라우드 지원 - 올라마 클라우드 플랫폼과의 완전 통합
• 🔧 14 종합 도구 - 올라마의 SDK 기능에 완전 접근
• 🔄 핫스왑 아키텍처 - 제로 설정을 통한 자동 도구 발견
• 🎯 Type-Safe - TypeScript와 Zod 검증으로 구축됨
• 📊 높은 테스트 커버리지 - 96%+ 커버리지와 종합 테스트 패키지
• 🚀 **의존성 제로 - 최소한의 크기, 최대 성능
• 🔌 드롭인 통합 - Claude Desktop, Cline 및 기타 MCP 클라이언트와 호환
• 🌐 웹 검색 및 가져오기 - Ollama Cloud를 통한 실시간 웹 검색 및 콘텐츠 추출
• 🔀 하이브리드 모드 - 하나의 서버에서 로컬 및 클라우드 모델을 원활하게 활용함

💡 클로드 코드와 데스크톱으로 올라마 경험을 한 단계 끌어올리세요

완전 패키지: 도구 + 지식

---

✨ Features

• ☁️ Ollama Cloud Support - Full integration with Ollama’s cloud platform
• 🔧 14 Comprehensive Tools - Full access to Ollama’s SDK functionality
• 🔄 Hot-Swap Architecture - Automatic tool discovery with zero-config
• 🎯 Type-Safe - Built with TypeScript and Zod validation
• 📊 High Test Coverage - 96%+ coverage with comprehensive test suite
• 🚀 Zero Dependencies - Minimal footprint, maximum performance
• 🔌 Drop-in Integration - Works with Claude Desktop, Cline, and other MCP clients
• 🌐 Web Search & Fetch - Real-time web search and content extraction via Ollama Cloud
• 🔀 Hybrid Mode - Use local and cloud models seamlessly in one server

💡 Level Up Your Ollama Experience with Claude Code and Desktop

The Complete Package: Tools + Knowledge

This MCP server gives Claude the tools to interact with Ollama - but you’ll get even more value by also installing the Ollama Skill from the Skillsforge Marketplace:

• 🚗 This MCP = The Car - All the tools and capabilities
• 🎓 Ollama Skill = Driving Lessons - Expert knowledge on how to use them effectively

The Ollama Skill teaches Claude:

• Best practices for model selection and configuration
• Optimal prompting strategies for different Ollama models
• When to use chat vs generate, embeddings, and other tools
• Performance optimization and troubleshooting
• Advanced features like tool calling and function support

Install both for the complete experience:

1. ✅ This MCP server (tools)
2. ✅ Ollama Skill (expertise)

Result: Claude doesn’t just have the car - it knows how to drive! 🏎️

📦 Installation

Quick Start with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "ollama": {
      "command": "npx",
      "args": ["-y", "ollama-mcp"]
    }
  }
}