patruff/ollama-mcp-bridge

A TypeScript implementation that connects local LLMs (via Ollama) to Model Context Protocol (MCP) servers. This bridge allows open-source models to use the same tools and capabilities as Claude, enabling powerful local AI assistants.
## Overview
This project bridges local Large Language Models with MCP servers that provide various capabilities like:
Filesystem operations
Brave web search
GitHub interactions
Google Drive & Gmail integration
Memory/storage
Image generation with Flux
The bridge translates between the LLM's outputs and the MCP's JSON-RPC protocol, allowing any Ollama-compatible model to use these tools just like Claude does.
## Current Setup
LLM: Using Qwen 2.5 7B (qwen2.5-coder:7b-instruct) through Ollama
MCPs:
Filesystem operations (@modelcontextprotocol/server-filesystem)
Brave Search (@modelcontextprotocol/server-brave-search)
GitHub (@modelcontextprotocol/server-github)
Memory (@modelcontextprotocol/server-memory)
Flux image generation (@patruff/server-flux)
Gmail & Drive (@patruff/server-gmail-drive)
## Architecture
Bridge: Core component that manages tool registration and execution
LLM Client: Handles Ollama interactions and formats tool calls
MCP Client: Manages MCP server connections and JSON-RPC communication
Tool Router: Routes requests to appropriate MCP based on tool type
### Key Features
Multi-MCP support with dynamic tool routing
Structured output validation for tool calls
Automatic tool detection from user prompts
Robust process management for Ollama
Detailed logging and error handling
## Setup
1. Install Ollama and required model:
bash
ollama pull qwen2.5-coder:7b-instruct
2. Install MCP servers:
bash
npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-brave-search
npm install -g @modelcontextprotocol/server-github
npm install -g @modelcontextprotocol/server-memory
npm install -g @patruff/server-flux
npm install -g @patruff/server-gmail-drive
3. Configure credentials:
Set BRAVEAPIKEY for Brave Search
Set GITHUBPERSONALACCESSTOKEN for GitHub
Set REPLICATEAPITOKEN for Flux
Run Gmail/Drive MCP auth: node path/to/gmail-drive/index.js auth
For example node C:\Users\patru\AppData\Roaming\npm\nodemodules\@patruff\server-gmail-drive\dist\index.js auth
## Configuration
The bridge is configured through bridgeconfig.json:
MCP server definitions
LLM settings (model, temperature, etc.)
Tool permissions and paths
Example:
json
"mcpServers": {
"filesystem": {
"command": "node",
"args": ["path/to/server-filesystem/dist/index.js"],
"allowedDirectory": "workspace/path"
},
// ... other MCP configurations
},
"llm": {
"model": "qwen2.5-coder:7b-instruct",
"baseUrl": "http://localhost:11434"
## Usage
1. Start the bridge:
bash
npm run start
2. Available commands:
list-tools: Show available tools
Regular text: Send prompts to the LLM
quit: Exit the program
Example interactions:
> Search the web for "latest TypeScript features"
[Uses Brave Search MCP to find results]