Tobias J. Endres 6cff3d92ca feat: add openviking MCP to fleet

OpenViking is a Context Database for AI Agents from Volcengine.
Uses upstream Docker image (ghcr.io/volcengine/openviking:latest)
with native HTTP MCP endpoint on port 1933 at /mcp.

- openviking/Dockerfile: FROM upstream image
- openviking/README.md: env vars, usage, client config, tools
- README.md: add 1933 port entry
- .woodpecker.yml: add pull+tag build step for openviking

2026-06-24 00:42:42 +02:00

2.5 KiB

Raw Blame History

openviking-mcp

OpenViking: Context Database for AI Agents — semantic search, memory management, resource ingestion, and session management over MCP.

Source: volcengine/OpenViking

OpenViking has a built-in HTTP MCP endpoint at /mcp on port 1933 — no mcp-proxy needed.

Prerequisites

A valid ov.conf configuration file is required. Generate one:

docker run --rm -it \
  -v ~/.openviking:/app/.openviking \
  forgejo.corentic.eu/corentic/mcp-fleet-openviking:latest \
  openviking-server init

Validate setup:

docker run --rm -it \
  -v ~/.openviking:/app/.openviking \
  forgejo.corentic.eu/corentic/mcp-fleet-openviking:latest \
  openviking-server doctor

Environment Variables

Variable	Required	Description
`OPENVIKING_CONFIG_FILE`	No	Path to ov.conf inside container (default: `/app/.openviking/ov.conf`)
`OPENVIKING_CONF_CONTENT`	No	Inline config content (alternative to volume mount)
`OPENVIKING_SERVER_HOST`	No	Server bind address (default: `0.0.0.0`)
`OPENVIKING_PUBLIC_BASE_URL`	No	Public URL for file upload signed URLs (needed behind reverse proxy)
`OPENVIKING_WITH_BOT`	No	Set to `0` to disable VikingBot

Usage

docker run -d \
  --name openviking-mcp \
  -p 1933:1933 \
  -v ~/.openviking:/app/.openviking \
  --restart unless-stopped \
  forgejo.corentic.eu/corentic/mcp-fleet-openviking:latest

MCP endpoint: http://host:1933/mcp

Client Configuration

Connect from any MCP client:

{
  "mcpServers": {
    "openviking": {
      "url": "http://host:1933/mcp"
    }
  }
}

Add "headers": {"Authorization": "Bearer your-api-key"} if auth is configured.

Tools

Tool	Description
`search`	Semantic search across memories, resources, and skills
`read`	Read one or more `viking://` URIs
`list`	List entries under a `viking://` directory
`store`	Store messages into long-term memory
`add_resource`	Add a local file or URL as a resource
`grep`	Regex content search across `viking://` files
`glob`	Find files matching a glob pattern
`forget`	Delete a `viking://` URI
`code_outline`	Show a file's symbol structure
`code_search`	Search symbol names across a directory
`code_expand`	Return full source of a named symbol
`health`	Check service health
`list_watches`	List auto-refresh subscriptions
`cancel_watch`	Cancel a watch task

2.5 KiB Raw Blame History