OpenViking

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 GitHub
• OpenCode
• MCP协议

版本

• OpenViking: 0.1.17
• MCP SDK: 1.25.0
• Python: 3.13+

许可证

MIT License