Oboyu (覚ゆ)
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
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.
- 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"
]
}
}
> Lightning-fast semantic search for your local documents with best-in-class Japanese support.

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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



