aliafsahnoudeh/shahnameh-mcp-server
shahnameh-mcp-server is a Model Context Protocol (MCP) server that enables AI assistants and other MCP clients to access the Shahnameh, the Persian epic poem written by Ferdowsi. It acts as a bridge between an MCP client and a dedicated Shahnameh API backend, which in turn relies on a specialized dataset. The server exposes a set of tools that allow querying specific sections, verses, and explanations from the epic, making it possible for language models to retrieve and discuss classic Persian literature programmatically. The project is part of a broader effort to preserve and promote the Persian language in the AI era, welcoming collaboration from developers and enthusiasts. Built entirely in Python, it uses standard tooling like `pyproject.toml` for packaging and can be inspected with the MCP Inspector for development and testing.
- Category
- Developer Tools
- Pricing
- Open Source
Problem solved
Researchers, developers, and AI systems previously lacked a standardized, programmatic interface to the Shahnameh, hindering its integration into modern AI applications. This tool solves that by providing an MCP-compliant server, enabling seamless querying of the epic's text for building educational, cultural, or analytical applications that require structured access to Persian literary content.
Use cases
- Building an AI chatbot that can narrate or explain stories from the Shahnameh
- Educational software for learning Persian language and literature through interactive queries
- Academic research analyzing linguistic patterns, motifs, or historical references in the epic
- Integration into cultural preservation apps to provide authoritative references to the poem
- Interactive storytelling applications that generate narratives based on user-selected themes
- Developing AI-powered search and discovery tools for Persian classical texts
Audience
- Developers
- Researchers
- Hobbyists
Pros
- Provides a standardized MCP interface for the Shahnameh, enabling AI integration
- Open source and community-driven
- Part of a larger initiative to support Persian language in AI
- Easy local testing with MCP Inspector
- Lightweight and written in Python
Cons
- Requires running a separate Shahnameh API and database, increasing setup complexity
- Early stage with minimal documentation and only one commit
- Limited to the scope of the underlying dataset and API
Official website: https://github.com/aliafsahnoudeh/shahnameh-mcp-server
Canonical LambdaBase page: https://www.lambdabase.com/tools/aliafsahnoudeh-shahnameh-mcp-server