Athena MCP RAG Server
Production-ready Pinecone-based RAG server for Claude Desktop with large-scale PDF ingestion, evaluation pipelines, and AI teaching tools
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
Production-ready Pinecone-based RAG server for Claude Desktop with large-scale PDF ingestion, evaluation pipelines, and AI teaching tools
Athena MCP RAG Server: Production-ready Pinecone-powered Retrieval-Augmented Generation server for Claude Desktop, with PDF ingestion, teacher tools (explain, study plans, quizzes)
git clone https://github.com/HarshRohilla04/Athena-MCP-RAG-server.git
cd Athena-MCP-RAG-server
uv sync
uv pip install -r requirements.txt
# OR
uv sync # uses pyproject.toml
-Create account at https://www.pinecone.io/
-Go to API Keys → copy your api key
-Create index:
Name: rag-storage # name your rag storage
Modality: Text
Vector type: Dense
Dimension: 1024
Metric: cosine
PINECONE_API_KEY = "your api key"
# ----------------------------------------------------------------------
# Global Configuration
# ----------------------------------------------------------------------
pc = Pinecone(api_key=os.getenv("PINECONE_API_KEY"))
index = pc.Index("name of the index")
uv run fastmcp install claude-desktop main.py
{
"SERVER_NAME": {
"command": "C:/Users/YOUR_USERNAME/Athena-MCP-RAG-server/.venv/Scripts/python.exe",
"args": ["C:/Users/YOUR_USERNAME/Athena-MCP-RAG-server/main.py"],
"env": {
"PINECONE_API_KEY": "your api key"
},
"transport": "stdio",
"cwd": "C:/Users/YOUR_USERNAME/Athena-MCP-RAG-server",
"timeout": 600
}
}
Save the JSON file
Close Claude Desktop completely
Open Task Manager → end all Claude processes
Restart Claude Desktop
Athena uses environment variables for all api keys, file paths, credentials, and model configuration. This makes the project portable across machines and operating systems.
Create a .env file using .env.example as reference.
# SAMPLE .ENV
PINECONE_API_KEY=your_key_here
PINECONE_INDEX_NAME=athena-rag
PINECONE_NAMESPACE=ml-theory-algorithms-text
OPENAI_API_KEY=your_api_key_here
# Documents
BOOK_PDF=/absolute/path/to/your/book.pdf
BOOK_NAME=Understanding Machine Learning: Theory and Algorithms
# Evaluation
TESTSET_CSV_PATH=/absolute/path/to/testset.csv
# Models
EMBEDDING_MODEL_NAME=BAAI/bge-large-en-v1.5
LLM_MODEL_NAME=gpt-4o-mini
Athena-MCP-RAG-server/
├─ main.py # MCP server for Claude Desktop
├─ pinecone_ingestion.py # Offline PDF ingestion
├─ testset_generator.py # Synthetic QA generation (RAGAS)
├─ evaluate_rag.py # RAG evaluation pipeline
├─ .env.example # Environment variable template
├─ requirements.txt
├─ testset_small(10Q).csv
├─ testset_large(100Q).csv
└─ README.md
This script ingests a textbook-scale PDF into Pinecone using a production-quality semantic ingestion pipeline.
Key features:
Required configuration:
Run ingestion:
python pinecone_ingestion.py
Note: Due to context window and transport limits, large PDFs are best ingested offline via pinecone_ingestion.py, while smaller documents can be safely uploaded through the Claude Desktop MCP interface.
Athena includes a complete RAG evaluation pipeline built using the RAGAS framework.
This allows users to quantitatively assess retrieval and generation quality rather than relying on subjective judgment.
The evaluation pipeline reports the following metrics:
The evaluation logic is implemented in:
evaluate_rag.py
Evaluation process:
Users can run the evaluation directly once documents are ingested into Pinecone.
This script generates synthetic question–answer pairs from the source PDF using the RAGAS testset generator.
Generation process:
Required configuration:
Run testset generation:
python testset_generator.py
Output:
testset.csv
Note: MiniLM embeddings are used only during testset generation. Retrieval and evaluation use BGE-large embeddings
To make evaluation reproducible and easy to run, this repository includes two pre-generated testsets derived from the textbook Understanding Machine Learning.
testset_small(10Q).csv 10-question lightweight testset for quick sanity checkstestset_large(100Q).csv 100-question comprehensive testset for robust evaluationEach testset contains:
These CSV files allow users to evaluate Athena’s RAG performance immediately without regenerating test data.
This project is built around the book:
Understanding Machine Learning: From Theory to Algorithms Shai Shalev-Shwartz and Shai Ben-David Download Book
The book is used for:
Athena MCP RAG Server: Production-ready Pinecone-powered Retrieval-Augmented Generation server for Claude Desktop, with PDF ingestion, teacher tools (explain, study plans, quizzes)
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Athena MCP RAG Server läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. Athena MCP RAG Server: Production-ready Pinecone-powered Retrieval-Augmented Generation server for Claude Desktop, with PDF ingestion, teacher tools (explain, study plans, quizzes)