How do I use opencode-personal-knowledge?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@opencode-personal-knowledge search for knowledge about deployment" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

opencode-personal-knowledge

by NocturnLabs

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

Store and retrieve knowledge using semantic search, powered by local embeddings. No external API keys required.

✨ Features

🔍 Semantic Search — Find knowledge using vector embeddings (BGE-small-en-v1.5)
📝 Text Search — Keyword-based search fallback
🏷️ Tag Organization — Categorize entries with tags
🔌 Plug-and-Play — No external services required (embeddings run 100% locally)
💾 Persistent Storage — Data stored in ~/.local/share/opencode-personal-knowledge/
🔄 Automatic Indexing — Entries are vectorized on creation

Related MCP server: local-memory-mcp

🚀 Quick Start

Opencode Integration (Recommended)

Add to ~/.config/opencode/opencode.jsonc:

{
  "mcp": {
    "personal-knowledge": {
      "type": "local",
      "command": ["bunx", "opencode-personal-knowledge"],
      "enabled": true
    }
  }
}

Restart Opencode — the MCP tools will be available immediately.

Source Installation (Development)

git clone https://github.com/NocturnLabs/opencode-personal-knowledge.git
cd opencode-personal-knowledge
bun install
bun run mcp  # Start MCP server

🛠️ MCP Tools

Knowledge Tools

Tool	Description
`store_knowledge`	Store a new knowledge entry with optional tags
`search_knowledge`	Semantic similarity search
`search_knowledge_text`	Keyword-based text search
`get_knowledge`	Retrieve entry by ID
`update_knowledge`	Update an existing entry
`delete_knowledge`	Delete an entry
`list_knowledge`	List entries with filters
`get_knowledge_stats`	Database statistics

Session Memory Tools

Log and search across entire OpenCode sessions.

Tool	Description
`start_logging_session`	Begin logging a session
`log_message`	Log a user/agent message to the session
`search_session`	Semantic search within a session
`search_all_sessions`	Search across ALL logged sessions
`list_sessions`	List all sessions
`get_session`	Get session details and messages
`end_session`	End session with optional summary

📖 Example Usage

Storing Knowledge

User: "store a knowledge entry about Opencode Features"

Agent: Researches and stores entry:

✅ Stored knowledge entry #2: "Opencode Features"
📊 Indexed for semantic search

Searching Knowledge

User: "@search_knowledge for opencode"

Agent: Returns semantic matches:

Found 1 similar entry:

### 1. Opencode Features (85% similar)
Opencode is an open source AI coding agent...

Session Memory

User: "Start logging this session, call it 'auth debugging'"

Agent: Starts session and logs all exchanges:

✅ Started session #1: "auth debugging"

User: "Search this session for JWT"

Agent: Returns semantic matches from the session:

Found 2 matches in session #1:

### 1. [user] (92% match)
The JWT token expires too fast...

### 2. [agent] (88% match)
The TTL is set to 60 instead of 3600...

⚙️ Configuration

Data Location

By default, data is stored in:

~/.local/share/opencode-personal-knowledge/
├── knowledge.db      # SQLite database
└── vectors/          # LanceDB vector store

Override with environment variable:

export OPENCODE_PK_DATA_DIR=/custom/path

Embedding Model

Uses BGE-small-en-v1.5 via FastEmbed (auto-downloads on first use).

🏗️ Technology Stack

Runtime: Bun / Node.js
Vector DB: LanceDB (embedded)
Embeddings: FastEmbed (ONNX Runtime)
MCP SDK: @modelcontextprotocol/sdk
Database: SQLite (via Bun)

📄 License

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

Mirror Memory MCP Server
io.github.Tr1ckyMag1ca1
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
Knowledge & Memory Search Note Taking
2
nexsusOAuth
io.github.dbnexsus
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Knowledge & Memory RAG Systems
2
gread A
io.github.NitroRCr
An MCP server that gives your AI access to the source code and docs of all public github repos
Version Control Code Analysis Documentation Access
5364
driflyte-mcp-server
com.driflyte
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Search Web Scraping Knowledge & Memory
211

Related MCP Servers

OmniHub
Knowledge & Memory Search Developer Tools
malharrrr
A
license
Not graded
quality
D
maintenance
A local-first MCP server for personal memory management, enabling AI agents to store, search, and retrieve developer insights with offline semantic search and auto-categorization.
Updated 3 months ago (2026-06-08 11:08 UTC)
6 npm
3
MIT
local-memory-mcp
Knowledge & Memory AI & Machine Learning
basst85
F
license
Not graded
quality
D
maintenance
A local MCP server that provides semantic memory storage and retrieval for coding and AI agents, enabling durable context across chat sessions.
Updated 7 months ago (2026-02-15 20:39 UTC)
49 npm
4
-
RAG MCP Server
RAG Systems Vector Databases
sglwsjxh
A
license
Not graded
quality
C
maintenance
A RAG knowledge base MCP server that adds vector search and reranking capabilities to opencode, supporting multimodal embeddings, multiple knowledge bases, and local storage.
Updated 3 months ago (2026-06-12 05:09 UTC)
1
MIT
team-docs-mcp
RAG Systems Documentation Access Knowledge & Memory
jpnqs
F
license
Not graded
quality
D
maintenance
An MCP server for team documentation and knowledge bases, enabling semantic search over documentation files using local embeddings.
Updated 5 months ago (2026-04-28 18:37 UTC)
-