Skip to main content
Glama
Sign In
OpenViking MCP Server

OpenViking MCP Server

by jonsonliai
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

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

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Resources

Related MCP Connectors