Skip to main content
Glama
jonsonliai

OpenViking MCP Server

by jonsonliai

OpenViking MCP Server

MCP Server for integrating OpenViking context database with Cloudwise SA Workflow Skills.

Features

  • Semantic Search: Query knowledge base with natural language

  • Product Catalog: Access Cloudwise product information (APM, DOEM, CMDB, etc.)

  • Solution Templates: Retrieve industry-specific solutions

  • Hierarchical Context: L0/L1/L2 tiered loading for optimal token usage

  • Mock Mode: Test without real OpenViking server or API keys

Quick Start

Installation

cd openviking-mcp
pip install -e ".[dev]"

Mock Mode (No API Key Required)

# Run in mock mode for testing
export OPENVIKING_MOCK_MODE=true
python -m openviking_mcp.server

Real Mode (Requires OpenViking Server)

# Start OpenViking server first
openviking-server --port 1933

# Then run MCP server
export OPENVIKING_URL=http://localhost:1933
python -m openviking_mcp.server

Configuration

Environment variables:

Variable

Default

Description

OPENVIKING_URL

http://localhost:1933

OpenViking HTTP API URL

OPENVIKING_STORE

cloudwise-kb

Default store name

OPENVIKING_TIER_DEFAULT

L1

Default context tier (L0/L1/L2)

OPENVIKING_MOCK_MODE

false

Enable mock mode for testing

OPENVIKING_HTTP_TIMEOUT

30

HTTP request timeout

Claude Desktop Configuration

Add to ~/.claude/mcp-servers/openviking-mcp.json:

{
  "name": "openviking-mcp",
  "transport": "stdio",
  "command": "python",
  "args": ["-m", "openviking_mcp.server"],
  "env": {
    "OPENVIKING_URL": "http://localhost:1933",
    "OPENVIKING_STORE": "cloudwise-kb",
    "OPENVIKING_MOCK_MODE": "false"
  }
}

Available Tools

Tool

Description

query_kb

Semantic search across knowledge base

get_product

Get Cloudwise product details

get_solution

Retrieve solution templates

list_directory

Browse KB directory structure

get_context_tier

Get L0/L1/L2 context levels

Development

# Run tests
pytest tests/ -v

# Run with coverage
pytest tests/ --cov=openviking_mcp

# Run mock mode demo
python scripts/demo_mock.py

# Lint
ruff check src/
mypy src/

Mock Mode

Mock mode provides simulated responses for development and testing without requiring:

  • OpenViking server running

  • Embedding API keys

  • Actual knowledge base data

Enable mock mode:

export OPENVIKING_MOCK_MODE=true

Architecture

22 SA Skills → MCP Client → MCP Server → HTTP Client → OpenViking API → KB
                                ↓
                           Mock Mode (可选)

License

MIT

F
license - not found
-
quality - not tested
-
maintenance - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Connectors

  • Shared, permission-aware company context for AI agents, with provenance, approvals and audit.

  • Securely search and manage workspace context files for AI agents and teams.

  • Curated knowledge API for AI agents - skill packs, semantic search, validated patterns.

View all MCP Connectors

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/jonsonliai/openviking-mcp'

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