Skip to main content
Glama
alrcatraz

astra-knowledge-base-mcp

by alrcatraz

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ASTRA_KB_PATHNoPath to the SQLite database file~/.astra/knowledge-base.db

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
kb_listA

List all knowledge bases with their enable/disable status

kb_createC

Create a new empty knowledge base

kb_deleteA

Permanently delete a knowledge base and all its content

kb_enableB

Enable a knowledge base so it appears in search results

kb_disableA

Disable a knowledge base so it is excluded from search

kb_addC

Add text content to a knowledge base (auto-chunked)

kb_searchA

Search across enabled (or specified) knowledge bases. Default: hybrid (FTS + vector)

kb_list_chunksB

List chunks in a knowledge base (paginated)

kb_updateA

Update a chunk. Unset fields keep current value. mode='append' appends to content.

kb_delete_chunkB

Delete a single chunk by ID

kb_extractC

Extract events and entities from unprocessed chunks (SAG indexing). Reference: arXiv 2606.15971

mgmt_list_tablesA

List available operational tables (services, health_log, api_keys, ...)

mgmt_queryC

Query operational data from mgmt schema tables

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 13 tools

Disambiguation5/5

All tools have distinct purposes: KB management (list, create, delete, enable, disable), content operations (add, search, extract, list_chunks, update, delete_chunk), and admin queries (mgmt_list_tables, mgmt_query). No overlapping functionality.

Naming Consistency5/5

All tool names follow a consistent 'prefix_verb_noun' pattern using snake_case. Prefixes 'kb_' and 'mgmt_' clearly separate knowledge base and management operations. Verbs are descriptive and uniformly styled.

Tool Count5/5

13 tools is well-scoped for a knowledge base MCP server. It provides comprehensive operations without being excessive, covering CRUD for KBs and chunks, search, extraction, and administrative functions.

Completeness4/5

The tool surface covers most essential operations: KB lifecycle (create, delete, list, enable/disable), chunk management (add, list, update, delete), search, and extraction. Minor gaps include lack of a single-KB retrieval tool and no update for KB metadata, but core workflows are supported.

Maintenance

ActivitySlowing
ResponsivenessNo issues