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