goose-with-mcp-servers

What is goose-with-mcp-servers?

A Docker image that bundles the Goose AI agent with MCP (Model Context Protocol) servers. It allows users to run Goose in a containerized environment and configure it to connect to local or remote LLMs—for example, via Ollama. The image also supports adding MCP extensions such as the GitHub server.

How to use goose-with-mcp-servers?

Run goose configure to set up the LLM provider (e.g., Ollama) and to add extensions like the GitHub MCP server. The dev container automatically installs Goose via a postCreateCommand that runs curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash. A system dependency (libdbus-1-3) must be installed via sudo apt-get.

Key features of goose-with-mcp-servers

• Pre-packaged Docker image with Goose and MCP servers.
• Configuration wizard via goose configure.
• Example setup for Ollama using host.docker.internal.
• Supports adding the GitHub MCP server as a command-line extension.
• Automatic Goose installation in dev containers.
• Requires libdbus-1-3 as a system dependency.

Use cases of goose-with-mcp-servers

• Run Goose with a local Ollama instance inside Docker.
• Extend Goose with GitHub capabilities using the official MCP server.
• Create reproducible development environments with Goose pre-installed.

FAQ from goose-with-mcp-servers

How do I configure Goose to use Ollama in Docker?

Run goose configure and select Ollama as the provider. When asked for OLLAMA_HOST, use host.docker.internal instead of localhost because of Docker networking.

How do I add the GitHub MCP server?

Run goose configure, choose “Add Extension”, then “Command-line Extension”. Name it “GitHub”, set the command to npx -y @modelcontextprotocol/server-github, and add the GITHUB_PERSONAL_ACCESS_TOKEN environment variable.

What system dependencies are required?

Goose requires libdbus-1-3. Install it by running sudo apt-get update && sudo apt-get install -y libdbus-1-3.

How is Goose installed automatically in a dev container?

The postCreateCommand in the devcontainer configuration runs a curl script that downloads and installs the Goose CLI without running the initial configuration (CONFIGURE=false).