mcp-rag-showcase
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-rag-showcase
One retrieval contract. Two MCP servers — C# and Python. Same answers, proven by a test.
A minimal, fully free reference implementation of a RAG tool surface over the Model Context Protocol, written twice against one frozen spec and one shared corpus. No API keys, no model downloads, no vector database, no cloud spend.
What it proves
Claim | How you check it |
The tool contract is language-agnostic | Three tools, implemented independently in C# and Python |
Retrieval is reproducible | BM25 with frozen constants, no model, no randomness |
Both implementations agree |
|
It runs in a container |
|
It costs nothing | No secret, no paid dependency; Render free tier |
Related MCP server: neonrecall
Quick start
git clone https://github.com/Steinantonio/mcp-rag-showcase.git
cd mcp-rag-showcase
./scripts/bootstrap.ps1 # .venv + pip + dotnet restore
./scripts/test.ps1 # 72 pytest + 26 xunit + 10/10 parity
./scripts/serve.ps1 # Python on :8080 (REST + MCP)Both services, side by side over MCP:
./scripts/up.ps1 # docker compose up, both containers
./scripts/smoke.ps1 # same query, both servers, citations comparedSurfaces
Surface | Python | .NET |
MCP (streamable HTTP) |
|
|
REST + OpenAPI |
| — |
Health |
|
|
Tools in both: search(query, k), get_document(docId), answer(query, k). Answers are extractive — source
sentences with citations, no generator model.
Real output
$ ./scripts/smoke.ps1
query: restore a database backup
python ops-backups#00 ops-data-retention#01 ops-faq#01
dotnet ops-backups#00 ops-data-retention#01 ops-faq#01
MATCH
5/5 queries matchedFull transcript: docs/demo.md.
Repository map
corpus/ 15 authored docs + 10 golden queries (frozen)
src/mcp_rag_py/ core/ (pure) · adapters/ (REST, MCP, filesystem) · apps/
src/Mcp.Rag.Dotnet/ Core/ (tokenizer, chunker, BM25, engine) · Adapters/
tests/ unit · conformance · integration · arch · fixtures
specs/ agents/ spec-driven delivery and the six agent roles
docs/ concepts · tool contract · ADRs · demo · deploy · OpenAPI
infra/ Dockerfile x2 · main.bicep (validated, never deployed)Design decisions
ADR | Decision |
BM25 and extractive answers instead of embeddings + LLM | |
Freeze the spec; prove parity with hand-derived vectors | |
MCP + REST facade; one free service | |
Ports and adapters with a pure core |
Architecture in four analogies: docs/concepts.md.
Honest limitations
Lexical retrieval only. No synonyms, no paraphrase.
"how long do we keep backups"ranks a monitoring document first because of shared words — measured, documented, not hidden.Extractive answers. Stitched quotes, not prose.
15 documents. Demonstrates the shape of a pipeline, not retrieval quality.
Cold start. The deployed free instance sleeps after 15 idle minutes and takes ~1 minute to wake.
No auth. The corpus is authored for this repo and is public on purpose.
Docs
Concepts · Tool contract · Demo · Deploy · Methodology · Build plan · OpenAPI
License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search and manage your team's knowledge from MCP clients.
Query your own PDFs and documents from any MCP client. Every answer cites the page it came from.
Make your knowledge agent-ready. One MCP endpoint, 5 connectors, 3 search modes.
Team docs served to AI agents over MCP - search, Markdown reads, version pinning, read audit.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to connect document sources, prepare searchable documents, and run RAG-ready lexical, vector, or hybrid search with account-scoped document access.31 PyPIBSD 3-Clause

neonrecallofficial
AlicenseBqualityBmaintenanceEnables MCP clients to search ingested documents and ask citation-backed questions through the search_docs and ask tools.2MIT- AlicenseAqualityCmaintenanceEnables MCP clients to search and retrieve approved, role-filtered internal knowledge with PII redaction, citations, content-integrity checks, and tamper-evident audit logging.31MIT
- AlicenseAqualityBmaintenanceEnables MCP clients to query a document knowledge base with permission-aware hybrid retrieval, listing sources, searching snippets, and fetching document context while reporting confidence for each result.3Apache 2.0