About Opencode Personal Knowledge
Opencode Personal Knowledge is an MCP server published by NocturnLabs in the AI category: 🧠 Personal knowledge MCP server with vector database for Opencode. Store and retrieve knowledge using semantic search, powered by local embeddings.
The repository has 8 stars and 2 forks, with the last commit 10 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/NocturnLabs/opencode-personal-knowledgeThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
delete_knowledgeDelete an entry
Parameters not published.
get_knowledgeRetrieve entry by ID
Parameters not published.
get_knowledge_statsDatabase statistics
Parameters not published.
list_knowledgeList entries with filters
Parameters not published.
search_knowledgeSemantic similarity search
Parameters not published.
search_knowledge_textKeyword-based text search
Parameters not published.
store_knowledgeStore a new knowledge entry with optional tags
Parameters not published.
update_knowledgeUpdate an existing entry
Parameters not published.
Ask AI
Ask AI about Opencode Personal Knowledge
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
4 checks have not been run yet.
README
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
🚀 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
MIT © NocturnLabs
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.