mcp-configurator

MCP Configurator

Model Context Protocol (MCP) connects ollama-agent to external tools, databases, and developer services. In ollama-agent, MCP servers can be attached globally to the main orchestrator agent or scoped locally to specific subagents.

MCP Configuration Scopes

Scope	Configuration File	Virtual Agent Path	Description
Main Agent (Global)	~/.ollama-agent/mcp.json	/agent/mcp.json	Global MCP tools available directly to the main agent orchestrator.
Subagent (Scoped)	~/.ollama-agent/settings.yaml	/agent/settings.yaml	Dedicated MCP tools available only within an isolated subagent's execution graph.

---

1. Main Agent MCP Configuration (/agent/mcp.json)

The global configuration file resides at /agent/mcp.json (persisted at ~/.ollama-agent/mcp.json). It uses JSON format with a top-level "mcpServers" object.

Schema & Supported Transports

A. Standard I/O Subprocess (stdio)

Runs an executable as a local subprocess communicating via stdio:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/directory"],
      "cwd": "/path/to/directory",
      "env": {
        "DEBUG": "true"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git"]
    }
  }
}

• command (string, required): Executable command (e.g. npx, uvx, python, node, docker, or binary path).
• args (array of strings, optional): Command-line arguments.
• cwd (string, optional): Working directory for the spawned process.
• env (object, optional): Environment variables. Values support ${VAR} and %VAR% expansion from the host environment.
• transport (string, optional): Defaults to "stdio" when command is present.