pioreactor-knowledge-base

MCP tools for accessing domain knowledge files stored on a Pioreactor. Registers two tools with the Pioreactor's built-in MCP server:

• list_knowledge_files() — Returns a list of .md filenames and their descriptions (parsed from YAML frontmatter)
• read_knowledge_file(filename) — Returns the contents of a specific .md file

Installation

pio plugins install pioreactor_knowledge_base --source https://github.com/Change-Bio/pioreactor-knowledge-base/archive/main.zip

Knowledge file format

Place .md files in ~/knowledge/ (configurable via knowledge_dir in config). Each file should have YAML frontmatter with a description field:

---
description: >
  Brief description of what this knowledge file covers.
  This is returned by list_knowledge_files() so the agent can decide which file to read.
---

# Title

Content here...

Configuration

The knowledge directory defaults to /home/pioreactor/knowledge. Override in config.ini:

[knowledge_base.config]
knowledge_dir=/home/pioreactor/knowledge

Setup

Create the knowledge directory and add your .md files:

mkdir -p ~/knowledge
# Copy your knowledge files here

See knowledge/example.md for the expected file format.