Oboyu (覚ゆ)

by sonesuke

372 downloads
Not rated
GitHub

About

Self-hosted MCP Japanese text indexing & search—chunking+embeddings with BM25×vector rerank

Details

Author
sonesuke
Downloads
372
Categories
Knowledge Base

- Hybrid search combining semantic understanding and keyword matching.
- Supports plain text, Markdown, PDFs, code files, and Jupyter notebooks.
- Automatic Japanese encoding detection (Shift-JIS, EUC-JP, UTF-8).
- ONNX acceleration for 2–4x faster performance.
- Built-in MCP server for Claude Desktop and AI coding assistants.
- Smart reranking and incremental indexing for speed.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Oboyu (覚ゆ)
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install with pip install oboyu or uv tool install oboyu. Index documents with oboyu index ~/Documents, then search interactively with oboyu query --interactive. For AI assistant integration, start the MCP server with oboyu mcp and configure it in Claude Desktop’s settings.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "oboyu (\u899a\u3086)": {
            "oboyu": {
                "command": "uv",
                "args": [
                    "tool",
                    "install",
                    "oboyu"
                ]
            }
        }
    }
}

McpServers

{
    "oboyu": {
        "command": "uv",
        "args": [
            "tool",
            "install",
            "oboyu"
        ]
    }
}

Oboyu (覚ゆ)

License: MIT
Python Version
PyPI Version

> Lightning-fast semantic search for your local documents with best-in-class Japanese support.

demo

What is Oboyu?

Oboyu (覚ゆ - "to remember" in ancient Japanese) is a powerful local semantic search engine that helps you instantly find information in your documents using natural language queries. Unlike traditional keyword search, Oboyu understands the meaning behind your questions, making it perfect for finding relevant content even when you don't know the exact terms.

Why Oboyu?

- 🚀 Fast: Indexes thousands of documents in seconds, searches in milliseconds
- 🎯 Accurate: Semantic search finds what you mean, not just what you type
- 🇯🇵 Japanese Excellence: First-class support with automatic encoding detection
- 🔒 Private: Everything runs locally - your documents never leave your machine
- 🤖 AI-Ready: Built-in MCP server for Claude, Cursor, and other AI assistants

Quick Start

Get up and running in under 5 minutes:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.