How do I use opencode-personal-knowledge?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

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

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Resources

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
https://hcelnlqmgddxzvjegpdr.supabase.co/functions/v1/mcp-server
SynaplanA
io.github.metadist
Self-hosted AI workspace: semantic RAG document search, long-term memory, and AI chat via MCP.
RAG Systems Knowledge & Memory AI & Machine Learning
101597
https://web.synaplan.com/mcp
nexsus
io.github.dbnexsus
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Knowledge & Memory RAG Systems
2
https://app.nexsus.com.au/mcp
greadA
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
5365
https://api.gread.dev/mcp

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 5 months ago (2026-06-08 11:08 UTC)
15 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 9 months ago (2026-02-15 20:39 UTC)
57 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 5 months ago (2026-06-12 05:09 UTC)
1
MIT
team-docs-mcp
RAG Systems Documentation Access Knowledge & Memory
jpnqs
A
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 6 months ago (2026-04-28 18:37 UTC)
MIT