1. Conduid
  2. AI
  3. Opencode Personal Knowledge
MCP server · AI

Opencode Personal Knowledge

by · github.com/NocturnLabs/opencode-personal-knowledge

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

Unclaimed last commit 8 months ago model-context-protocollancedbknowledge-managementmcpaiembeddingsopencodesemantic-search
InstallView source
51Fair

Scored 3 months ago · breakdown

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. It has been installed 0 times through Conduid.

The repository has 8 stars and 2 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx opencode-personal-knowledge

This 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.

Ask AI

✦

Ask AI about Opencode Personal Knowledge

Powered by Claude · Grounded in docs

I know everything about Opencode Personal Knowledge. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

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

📄 License

MIT © NocturnLabs

README mirrored from the source repository 3 months ago. The original is authoritative.

Questions

About Opencode Personal Knowledge

How do I install Opencode Personal Knowledge?

Run npx opencode-personal-knowledge, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Opencode Personal Knowledge safe to use with an AI agent?

Its trust score is 51 out of 100 (fair). It passes 0 of 1 static security checks; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Opencode Personal Knowledge still maintained?

The last commit was 8 months ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.