Skip to main content
Glama
jadenmaciel

OpenViking MCP Server

by jadenmaciel

OpenViking MCP Server

A lightweight MCP (Model Context Protocol) server that connects to a running OpenViking server via HTTP, exposing its context database capabilities to Claude Desktop and other MCP clients.

No native compilation required -- only depends on httpx and mcp.

Prerequisites

  • Python 3.10+

  • A running OpenViking server (openviking-server on port 1933 by default)

Related MCP server: miniMCP

Installation

pip install ./openviking-mcp
# or with uv
uv pip install ./openviking-mcp

Claude Desktop Setup

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "openviking": {
      "command": "openviking-mcp",
      "args": ["--server-url", "http://localhost:1933"],
      "env": {
        "OPENVIKING_API_KEY": "your-key-here"
      }
    }
  }
}

Claude Code Setup

claude mcp add openviking -- openviking-mcp --server-url http://localhost:1933

Or with HTTP transport:

openviking-mcp --transport streamable-http --port 2033
claude mcp add --transport http openviking http://127.0.0.1:2033/mcp

Available Tools

Tool

Description

search

Semantic search across memories, documents, and resources

add_resource

Ingest a file, directory, or URL for indexing

read_content

Read the full content of a resource by URI

get_overview

Get a structured summary of a resource (L1)

get_abstract

Get a one-line summary of a resource (L0)

list_contents

Browse directory contents at a Viking URI

add_memory

Store information for future recall

find_by_pattern

Find resources by filename glob pattern

grep_content

Exact text/regex search within resources

get_resource_info

Get resource metadata (type, size, status)

get_relations

View links between resources

health_check

Check OpenViking server connectivity

CLI Options

Flag

Env Var

Default

Description

--server-url

OPENVIKING_URL

http://localhost:1933

OpenViking server URL

--api-key

OPENVIKING_API_KEY

API key for authentication

--transport

stdio

stdio or streamable-http

--host

127.0.0.1

Bind host (HTTP transport)

--port

OPENVIKING_MCP_PORT

2033

Bind port (HTTP transport)

--timeout

60

HTTP request timeout (seconds)

--debug

OPENVIKING_MCP_DEBUG

false

Enable debug logging

License

Apache-2.0

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jadenmaciel/openviking-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server