OpenViking MCP Server

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)

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