# Ollama Mcpo Adapter

> Adapter to expose MCPO, the MCP-to-OpenAPI proxy server, tools in Ollama-compatible format

- **Type:** MCP server
- **Install:** `agentstack add mcp-tappi287-ollama-mcpo-adapter`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tappi287](https://agentstack.voostack.com/s/tappi287)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tappi287](https://github.com/tappi287)
- **Source:** https://github.com/tappi287/ollama-mcpo-adapter

## Install

```sh
agentstack add mcp-tappi287-ollama-mcpo-adapter
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🦙 ollama-mcpo-adapter

**Expose MCPO, the MCP-to-OpenAPI proxy server, tools as Ollama-compatible functions** using a simple Python adapter and optional runtime service.

---

## ✨ Features

- 🔌 Connect to a [MCPO](https://github.com/open-webui/mcpo) instance
- ⚙️ Launch your own MCPO server programmatically via `MCPOService`
- 🔁 List [MCP tools](https://modelcontextprotocol.info/docs) exposed via OpenAPI as Ollama-compatible tool functions

---

## 🚀 Quickstart

### 1. Install

```bash
pip install ollama-mcpo-adapter
```

### Usage with Existing MCPO Instance
Assuming you have MCPO running like this:
```bash
uvx mcpo --port 5090 --config /path/to/mcp_config.json
```
You can get all available functions in Ollama ToolCall format with the adapter:
```python
from ollama_mcpo_adapter import OllamaMCPOAdapter

adapter = OllamaMCPOAdapter(host="localhost", port=5090, config_path="/path/to/mcp_config.json")
# Gets tool descriptions from MCPO FastAPI /docs
tools = adapter.list_tools_ollama()
```
You can omit the config path. But discovery of MCP server names is more reliable with a provided config.
Otherwise, the server names will be read from the automatically generated OpenAPI docs [MCPO](https://github.com/open-webui/mcpo) provides which might change in the future.

---

### Usage with Local MCPO Service

You can start a MCPO service with this extension:
```python
from ollama_mcpo_adapter import MCPOService

# Provide your mcp config as JSON file or dictionary
mcp_config = {
    "mcpServers": {
        "time": {"command": "uvx", "args": ["mcp-server-time", "--local-timezone=Europe/Berlin"]}
    }
}
mcpo = MCPOService("127.0.0.1", 4090, config=mcp_config,
                   # -OR- from an existing mcp_config file 
                   config_path="path/to/mcp_config.json")
# MCPOSService class handles MCPO server start-up and shutdown and in a subprocess
mcpo.start(wait=True)
...
mcpo.stop()
```

Then get all available tools with the adapter:
```python
from ollama_mcpo_adapter import OllamaMCPOAdapter
adapter = OllamaMCPOAdapter("127.0.0.1", 4090)
tools = adapter.list_tools_ollama()
```

Send this to Ollama:
```python
from ollama import Client
# Send a prompt to Ollama using discovered tools
client = Client(host="http://127.0.0.1:11434")
response = client.chat(
    model="qwen2.5-coder:14b-instruct-q4_K_M",
    messages=[{"role": "user", "content": "Write a file..."}],
    tools=tools,
)
```

And finally call the tools:
```python
# Handle any tool calls
if response.message.tool_calls:
    adapter.call_tools_from_response(response.message.tool_calls)
```

---

### Env
- MS Windows npx path, you can overwrite npx with a path to npx in the config parser 
  
    example: `WIN_NODEJS_NPX_PATH=C:\Program Files\nodejs\npx.cmd`

---

### 🧪 Running Tests

```bash
pytest
```

---

### 📂 Project Structure

```
ollama_mcpo_adapter/
├── adapter.py        # Tool discovery + Ollama integration
├── service.py        # Optional: launch MCPO programmatically
├── service_runner.py # MCPO subprocess control
├── config_parser.py  # MCP config parsing helpers
├── dispatcher.py     # Dispatch tool calls
```

---

### 📜 License

MIT. See [LICENSE](./LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tappi287](https://github.com/tappi287)
- **Source:** [tappi287/ollama-mcpo-adapter](https://github.com/tappi287/ollama-mcpo-adapter)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** yes
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-tappi287-ollama-mcpo-adapter
- Seller: https://agentstack.voostack.com/s/tappi287
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.