Shahnameh MCP Server

What aliafsahnoudeh/shahnameh-mcp-server MCP server does

aliafsahnoudeh/shahnameh-mcp-server MCP server provides agent access to content from the Shahnameh, also known as the Book of Kings, the Persian epic poem by Ferdowsi. The available content is described as including sections, verses, and explanations. This makes the server relevant for applications that need to look up or work with Shahnameh material through the Model Context Protocol.

The repository is presented as one component of a larger project. It does not appear to contain the underlying literary dataset or operate as a standalone content database. Instead, it connects to the separate Shahnameh API project.

How it works

The MCP process calls the Shahnameh API behind the scenes. That API must be running before the MCP server can be used. The API itself relies on a database supplied by the separately maintained Shahnameh dataset repository.

This arrangement separates the agent-facing MCP layer from the API and data layers. To use aliafsahnoudeh/shahnameh-mcp-server MCP server, you therefore need the API service available in addition to this repository's Python entry point. The provided material does not specify the API's endpoint configuration, individual MCP tool names, request schema, or response format.

Setup and configuration

The documented workflow uses a Python virtual environment. From the repository, create one with uv venv, then activate it on macOS with source .venv/bin/activate. The README then shows the MCP Inspector invoking the server through python3 main.py:

uv venv
source .venv/bin/activate
npx @modelcontextprotocol/inspector python3 main.py

Before testing, start the Shahnameh API referenced by the project documentation. Its repository and the dataset repository are listed as separate dependencies, so setup is not limited to launching main.py. The provided material does not document environment variables, API credentials, deployment instructions, or a packaged installation command.

Tools and capabilities

The documented data scope includes:

• Access to Shahnameh sections
• Retrieval of verses
• Access to explanations associated with the text

The README explains how to launch the server through the Inspector but does not enumerate the MCP tools or describe their arguments. Developers should inspect the running server to determine the exact tool names and input requirements.

Limitations and notes

aliafsahnoudeh/shahnameh-mcp-server MCP server depends on the Shahnameh API being available. If that service is not running, the MCP layer cannot retrieve the referenced content. The API also depends on the Shahnameh dataset and its database, adding an external setup requirement.

The available information does not confirm support for specific desktop clients, hosted operation, authentication, or production deployment. It also does not state a software license. The repository's contribution note describes the project as part of an independent effort related to Persian language and literature, but it does not add technical configuration details.