🦙 ollama-mcpo-adapter

What is ollama-mcpo-adapter?

ollama-mcpo-adapter is a Python package that connects to a MCPO (MCP-to-OpenAPI proxy) server and lists its exposed MCP tools as Ollama-compatible function definitions, enabling tool calling from Ollama models.

How to use ollama-mcpo-adapter?

Install with pip install ollama-mcpo-adapter. Then create an OllamaMCPOAdapter instance pointing to a running MCPO server (or launch one with MCPOService) and call list_tools_ollama() to get tool definitions. Pass these tools to an Ollama chat request and use call_tools_from_response() to execute tool calls.

Key features of ollama-mcpo-adapter

• Connects to an existing MCPO instance via host and port
• Optionally launches a MCPO server programmatically with MCPOService
• Discovers MCP tools exposed through OpenAPI and converts them to Ollama tool format
• Reliable server name discovery with a provided MCP config path
• Supports Windows via WIN_NODEJS_NPX_PATH environment variable

Use cases of ollama-mcpo-adapter

• Exposing file system, time, or any MCP server tools to Ollama for function calling
• Building AI assistants that call external tools via MCP without switching paradigms
• Prototyping and testing Ollama models with real-world tool invocations

FAQ from ollama-mcpo-adapter

What dependencies does ollama-mcpo-adapter require?

Python 3.8+ and the ollama Python package for sending tool-calling requests.

Where does the MCP configuration live?

You provide the MCP config as a JSON dictionary or file path when using MCPOService; the OllamaMCPOAdapter also accepts an optional config_path for reliable server name discovery.

What about Windows compatibility?

Set the environment variable WIN_NODEJS_NPX_PATH to the full path of npx.cmd if the default npx path is not found.

Can I use ollama-mcpo-adapter without starting my own MCPO server?

Yes, point the adapter to an already running MCPO instance by specifying its host and port.

Is the adapter secure?

It communicates with MCPO over HTTP; consider network security and authentication if MCPO is exposed publicly (not detailed in the README).