angusforeman/MCP_SQL_Archivist

SQL Archivist

Research spike exploring the efficacy of using an MCP Server to encapsulate access to an Archive of content represented by A) SQL data B) unstructured data and C) simple business rules

A lightweight approach that uses two python files - one acting as the chat service which invokes and LLM and reads in a system prompt. The other is the MCP implementation (MCP server filename specified in the .env) which is invoked and initated at runtime. MCP server uses STDIO to communicate. Tool usage is colour coded in the chat UI. It is possibe to adjust any of the following and see the impact with a restart of two lines of python.

-LLM parameters like temp and top_p -System prompt text -MCP implementation

Observability is via ./logs or by supressing the --quiet flag to see tool execution in the UI (see Observability below)

Running the LLM with MCP to interogate the archive

Follow the steps below if recreating the environment or building the DB from scratch

uv run python azureopenai_mcp_chat.py

Sample queries

>Is the DuPrez Audio Archive healthy?
>>this should return a count of ~150

>is a recording of "the birds" in the archive?
>>this should return a positive response

>are the series of the birds quorom?"
>>this should activate a business rules lookup to qualify what qurom means

>yes (there is no auto-turn, so you need to give the LLM a chance to apply the rules via SQL)
>> Should confirm is the recordings are quorum

>How many recordings of A history of the world in 100 objects are there?
>>This will likely return 0 as the 100 programmes are actually listed by episode titles, an real world challenge with indexing of real world content

>Try checking other likely fields in the archive for these episodes  
>>This should find the recordings by searching under album or artists fields

Concepts in the MCP Server

• healthcheck
• SQL query
• Schema query
• Glossary
• Business rules
• Overview

Observability

watch logs in real time

tail -f logs/mcp_server_*.log

logging tools direct to console

NOTE: The logging of the MCP server in the console can be suppressed via the .env file

MCP_SERVER_PARAMS=--quiet

Runtime setup

uv add duckdb
uv addd mcp[cli]

Azure resource setup

Set up Azure OpenAI Chat GPT5 instance 
Update .env file based on the template and the Azure servive details
Use  the default LLM and MCPserver details from template

create new archiveDB and reimport of sample data

will be necessary if pulling fresh from repo

cd archivedb
uv run python create_archivedb.py #create table structure & indexes
uv run python import_to_archive.pt archive_metadata-examplefile.jsonl ## using --drop will clear any existing content
uv run python ./run_archivedb_query.py "select count(*) from audio_files" # validate record count