Oboyu (覚ゆ)

by sonesuke

372 downloads Not rated yet MIT license
GitHub

About

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

Details

License
MIT license

Explore

- Hybrid Search: Combines semantic understanding with keyword matching for best results
- Multiple Modes: Switch between semantic, keyword, or hybrid search modes
- Smart Reranking: Built-in AI reranker improves result accuracy
- Interactive Mode: Real-time search with command history and auto-suggestions

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

Get up and running in under 5 minutes:


pip install oboyu

bash


See our MCP Integration Guide for detailed setup instructions.

- Quick Start Guide - Get up and running in 5 minutes
- Troubleshooting - Solutions to common issues
- CLI Reference - Complete command-line interface documentation

git clone https://github.com/YOUR_USERNAME/oboyu.git
cd oboyu
uv sync
uv run pytest -m "not slow"

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"
        ]
    }
}

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.