astra-knowledge-base-mcp

MCP (Model Context Protocol) server for managing and searching multi-tenant knowledge bases.

Part of Astra AI Agent Infrastructure

Overview

Astra Knowledge Base MCP provides AI agents with persistent, searchable knowledge bases backed by SQLite + FTS5 — zero external dependencies, one file per deployment.

Each knowledge base is an isolated namespace with full-text search. Content is auto-chunked on ingestion using recursive text splitting.

Related MCP server: agent-memory

Prerequisites

• Python 3.11+

• uv — Python package manager (pip install uv)

Setup

1. Install dependencies

uv sync

2. Start

uv run server.py

The database file is created at ~/.astra/knowledge-base.db by default. Override with the ASTRA_KB_PATH environment variable.

Configuration

Usage

MCP Tools

Registering in Hermes Agent

Add to your Hermes config.yaml:

mcp_servers:
  astra-knowledge-base:
    command: /path/to/astra-knowledge-base-mcp/scripts/run.sh
    enabled: true

Then restart Hermes Agent. The tools (kb_list, kb_search, etc.) become available automatically.

Architecture

AI Agent (Hermes)
    │  MCP stdio protocol
    ▼
astra-knowledge-base-mcp (Python, uv run)
    │
    ├── SQLite (stdlib) → ~/.astra/knowledge-base.db
    │   ├── kb_registry    ← KB metadata & status
    │   ├── chunks         ← Content storage
    │   └── chunks_fts     ← FTS5 virtual table
    │
    └── PostgreSQL (psycopg2) → astra_kb
        ├── kb_registry       ← KB metadata & status
        ├── kb_*.chunks       ← Per-KB schema (tsvector FTS)
        └── mgmt              ← Operational data (services, health_log, api_keys)

Switch backends via ASTRA_KB_BACKEND=postgres or ASTRA_KB_BACKEND=sqlite (default).

Agent Guide

See AGENTS.md for AI-agent-oriented documentation (entry points, workflows, Hermes integration).

Related

• astra-aiagent-infra — ecosystem portal

• Hermes Agent — AI agent framework

• MCP — Model Context Protocol

Dependencies

This service has no external dependencies. The SQLite database is managed entirely via Python stdlib (sqlite3).

License

MIT — see LICENSE.

CI/CD: coming soon — see astra-aiagent-infra for ecosystem-wide pipeline plans.

中文版

概述

Astra Knowledge Base MCP 为 AI Agent 提供基于 SQLite + FTS5 的持久化、可搜索知识库——零外部依赖，每个部署一个文件。

每个知识库是一个隔离的命名空间，支持全文搜索。内容引入时自动进行递归文本分块。

依赖关系

此服务无外部 astra 生态依赖。SQLite 数据库完全通过 Python 标准库 sqlite3 管理。

<p align="center">