82 lines
1.7 KiB
Markdown
82 lines
1.7 KiB
Markdown
# Ollie
|
|
|
|
A Go CLI that connects Ollama LLMs to MCP (Model Context Protocol) servers for tool use. Built because I couldn't find what I wanted with existing tools.
|
|
|
|
## Quick Start
|
|
|
|
**Requirements:**
|
|
- Go 1.21+
|
|
- Ollama running locally (http://localhost:11434)
|
|
|
|
**Build:**
|
|
```bash
|
|
go build
|
|
```
|
|
|
|
**Run:**
|
|
```bash
|
|
./ollie config.json [model]
|
|
```
|
|
|
|
Default model is `qwen3:8b`. Override with any Ollama model name.
|
|
|
|
## Configuration
|
|
|
|
Create a JSON file defining your MCP servers:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"filesystem": {
|
|
"command": "mcp-server-filesystem",
|
|
"args": ["/path/to/allowed/directory"],
|
|
"env": {
|
|
"DEBUG": "true"
|
|
}
|
|
},
|
|
"disabled-example": {
|
|
"command": "some-server",
|
|
"disabled": true
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
**Options:**
|
|
- `command` - MCP server executable (required)
|
|
- `args` - Command arguments (optional)
|
|
- `env` - Environment variables (optional)
|
|
- `disabled` - Skip this server (optional)
|
|
|
|
MCP server commands must be in your PATH.
|
|
|
|
## Usage
|
|
|
|
Chat history displays in a scrollable viewport. Type in the multi-line text area below, submit with Enter (Ctrl+J for new lines).
|
|
|
|
Tools depend on which MCP servers you configure. Example with filesystem server:
|
|
|
|
```
|
|
> What files are in the current directory?
|
|
[Calling tool from filesystem server]
|
|
Found: main.go, config/, mcp/, ollama/, tools/
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
**No servers connected**
|
|
- Verify MCP server commands are in PATH
|
|
- Check command names and arguments in config
|
|
|
|
**Tools not working**
|
|
- Ensure servers support `tools/list` and `tools/call`
|
|
- Check tool arguments match expected schema
|
|
|
|
**Ollama errors**
|
|
- Start Ollama: `ollama serve`
|
|
- Verify model exists: `ollama list`
|
|
|
|
## License
|
|
|
|
GPLv3
|