Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OpenViking MCP Serversearch the knowledge base for APM installation steps"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.serverReal 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.serverConfiguration
Environment variables:
Variable | Default | Description |
|
| OpenViking HTTP API URL |
|
| Default store name |
|
| Default context tier (L0/L1/L2) |
|
| Enable mock mode for testing |
|
| 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 |
| Semantic search across knowledge base |
| Get Cloudwise product details |
| Retrieve solution templates |
| Browse KB directory structure |
| 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=trueArchitecture
22 SA Skills → MCP Client → MCP Server → HTTP Client → OpenViking API → KB
↓
Mock Mode (可选)License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.