Opencode Personal Knowledge

NocturnLabs16stars

🧠 Personal knowledge MCP server with vector database for Opencode. Store and retrieve knowledge using semantic search, powered by local embeddings.

Knowledge Memory Databases

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# Opencode Personal Knowledge

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Last checked: 2026-10-28

Stars: 16
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Opencode Personal Knowledge?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Opencode Personal Knowledge need an API key?

No required environment variable is listed on this record.

What transport does Opencode Personal Knowledge use?

Opencode Personal Knowledge runs locally over stdio.

When was Opencode Personal Knowledge last checked?

Last checked 2026-10-28. 🧠 Personal knowledge MCP server with vector database for Opencode. Store and retrieve knowledge using semantic search, powered by local embeddings.

From the publisher

Documentation

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

Opencode Personal Knowledge

NocturnLabs16stars

🧠 Personal knowledge MCP server with vector database for Opencode. Store and retrieve knowledge using semantic search, powered by local embeddings.

Knowledge Memory Databases

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# Opencode Personal Knowledge

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Last checked: 2026-10-28

Stars: 16
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Opencode Personal Knowledge?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Opencode Personal Knowledge need an API key?

No required environment variable is listed on this record.

What transport does Opencode Personal Knowledge use?

Opencode Personal Knowledge runs locally over stdio.

When was Opencode Personal Knowledge last checked?

Last checked 2026-10-28. 🧠 Personal knowledge MCP server with vector database for Opencode. Store and retrieve knowledge using semantic search, powered by local embeddings.

From the publisher

Documentation

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)