MCP 服务器

OpenViking MCP

Provides AI assistants with access to the OpenViking knowledge base for semantic search, document reading, and full-text retrieval. It enables vector-based intelligence, L0/L1 summaries, and glob-based pattern matching for local documentation.

README

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`	全文搜索