Manual setup required. We don't have a verified install command for this server. Follow the maintainer README and use the raw config below as a starting point.
1
Prepare the server locally
Run this once before adding it to Claude Code.
pip install openviking mcp2
Add it to Claude Code
Paste the maintainer's config below, then edit any placeholder values.
{
"mcp": {
"openviking": {
"type": "local",
"command": [
"python",
"path\\to\\openviking_mcp_server.py"
],
"environment": {
"OPENVIKING_DATA_PATH": "path\\to\\viking_data",
"OPENVIKING_CONFIG_FILE": "path\\to\\ov.conf"
},
"enabled": true,
"timeout": 20000
}
}
}See the openviking-mcp README for full setup instructions.
Required:
OPENVIKING_DATA_PATHOPENVIKING_CONFIG_FILE3
Make your agent remember this setup
openviking-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Semantic search using vector embeddings
- Support for reading PDF and Markdown documents
- Glob-based file pattern matching
- L0 summary and L1 overview generation
- Keyword-based full-text retrieval
Tools 6
openviking_findPerforms semantic search based on vector embeddings.openviking_readReads the content of documents like PDF or Markdown files.openviking_globPerforms pattern matching to search for files.openviking_abstractRetrieves L0 summaries for content.openviking_overviewRetrieves L1 overviews for content.openviking_grepPerforms keyword-based full-text search.Environment Variables
OPENVIKING_DATA_PATHrequiredPath to the directory containing knowledge base data.OPENVIKING_CONFIG_FILErequiredPath to the OpenViking configuration file.Try it
→Search the knowledge base for 'project architecture guidelines'.
→Read the document 'technical_spec.md' to summarize its key requirements.
→Find all markdown files in the documentation folder using pattern matching.
→Provide an L1 overview of the current project status.
→Perform a full-text search for the term 'security protocol' across all documents.
Original README from fencith/openviking-mcp
OpenViking MCP
OpenViking MCP Server - 为AI助手提供OpenViking知识库访问能力
功能
- 语义搜索 - 基于向量嵌入的智能检索
- 文档读取 - 读取PDF、MD等文档内容
- 模式匹配 - 使用glob模式搜索文件
- 摘要/概览 - 获取L0摘要和L1概览
- 全文搜索 - 关键字全文检索
快速开始
1. 安装依赖
pip install openviking mcp
2. 配置Ollama
确保Ollama服务运行中，并安装嵌入模型：
ollama serve
ollama pull qwen3-embedding:0.6b
3. 配置OpenCode
编辑 C:\Users\fenci\.config\opencode\opencode.json:
{
"mcp": {
"openviking": {
"type": "local",
"command": ["python", "path\\to\\openviking_mcp_server.py"],
"environment": {
"OPENVIKING_DATA_PATH": "path\\to\\viking_data",
"OPENVIKING_CONFIG_FILE": "path\\to\\ov.conf"
},
"enabled": true,
"timeout": 20000
}
}
}
4. 使用
在OpenCode中直接搜索：
使用 openviking 搜索"维斯塔斯接地"
项目结构
openviking-mcp/
├── openviking_mcp_server.py # MCP服务器实现
├── OPENVIKING_MCP_MANUAL.md # 详细文档
├── example_usage.py # 使用示例
├── ov.conf # 配置文件示例
├── viking_data/ # 数据目录(可选)
└── docs/ # 文档目录(可选)
可用工具
| 工具 | 功能 |
|---|---|
openviking_find |
语义搜索 |
openviking_read |
读取内容 |
openviking_glob |
模式匹配 |
openviking_abstract |
L0摘要 |
openviking_overview |
L1概览 |
openviking_grep |
全文搜索 |
文档
详细使用说明请参考 OPENVIKING_MCP_MANUAL.md
相关链接
版本
- OpenViking: 0.1.17
- MCP SDK: 1.25.0
- Python: 3.13+
许可证
MIT License