aliafsahnoudeh/shahnameh-mcp-server
🐍 🏠 🍎 🪟 🐧 - MCP server for accessing the Shahnameh (Book of Kings) Persian epic poem by Ferdowsi, including sections, verses and explanations.
Quick Install
{
"mcpServers": {
"aliafsahnoudeh-shahnameh-mcp-server": {
"command": "npx",
"args": [
"-y",
"aliafsahnoudeh-shahnameh-mcp-server"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
How to Use
Setup the different pieces
The MCP server calls the Shahnameh API behind the scenes, so you need to keep that running first. Please refer to the repository below for more information:
Also, please bear in mind that the API uses a database, which can be found here: Shahnameh Dataset
How to Test the Tools
Create and activate the virtual environment. For example, on macOS:
uv venv # Create the virtual environment
source .venv/bin/activate # Activate the virtual environment
Then run the inspector:
npx @modelcontextprotocol/inspector python3 main.py
هدف و مشارکت
این ریپازیتوری تنها یک بخش کوچک از پروژه ای مستقل برای خدمت به ایران و زبان و ادبیات پارسی می باشد. از تمامی عزیزانی که دل در گرو ایران و زنده نگهداشتن زبان پارسی در دوره هوش مصنوعی دارند با مهر و احترام دعوت به همکاری می شود.
شاهنامه زنده است.