Skip to main content
Glama
Linell

Grimoire

by Linell
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Grimoire

"World's okayest MCP-powered D&D 5e spellbook"

A Model Context Protocol (MCP) server that provides D&D 5e spell information through a set of tools. Built as a learning project to explore the Smithery MCP deployment platform.

Features

  • Spell search with filters (level, school, class, name, ritual, concentration)

  • Detailed spell information including casting time, components, and descriptions

  • Class-specific spell lists by level

  • Spell school and character class references

Related MCP server: D&D 5E MCP Server

Powered by D&D 5e API

This project is entirely powered by the D&D 5e API - a comprehensive, community-driven API that provides detailed information about D&D 5e spells, monsters, and more.

Quick Start

Prerequisites

  • Node.js 18+

  • npm or yarn

Installation

  1. Clone the repository:

git clone https://github.com/yourusername/grimoire.git
cd grimoire

  1. Install dependencies:

npm install

  1. Start the development server:

npm run dev

Available Tools

  • search_spells - Search for spells with various filters

  • get_spell - Get detailed information about a specific spell

  • list_schools - List all available D&D 5e spell schools

  • list_classes - List all available spellcasting character classes

  • get_class_spells - Get spells available to a specific class at a given level

Built with Smithery

This project is deployed using Smithery, a platform for deploying MCP servers that makes it easy to deploy, scale, and manage MCP servers with zero configuration.

Development

Project Structure

grimoire/
├── src/
│   └── index.ts          # Main MCP server implementation
├── package.json          # Dependencies and scripts
├── smithery.yaml         # Smithery deployment configuration
└── README.md            # This file

Local Development

Start the development server:

npm run dev

The server will be available at the local endpoint provided by Smithery CLI.

Configuration

  • debug (boolean): Enable debug logging (default: false)

Contributing

Contributions are welcome! This is a learning project, so feel free to:

  • Add new spell-related tools

  • Improve error handling

  • Enhance the documentation

  • Add tests

  • Suggest new features

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • D&D 5e API for providing comprehensive spell data

  • Smithery for the MCP deployment platform

  • The D&D 5e community for maintaining comprehensive game data

Links

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • LoreKeeper MCP

    frap129
    A
    license
    A
    quality
    B
    maintenance
    Provides fast, cached access to comprehensive Dungeons & Dragons 5th Edition data including spells, monsters, classes, races, equipment, and rules through Open5e and D\&D 5e APIs.
    7
    2
    MIT

  • D&D 5E MCP Server

    heffrey78
    F
    license
    B
    quality
    D
    maintenance
    Provides comprehensive access to Dungeons & Dragons 5th Edition content through the Open5e API. It enables users to search for game mechanics, generate character builds, and create balanced encounters via natural language.
    37
    22
    -

  • 5eMCP

    jazzsequence
    F
    license
    A
    quality
    A
    maintenance
    Enables D&D 5e game masters and players to access complete game reference data, search spells, monsters, items, and calculate encounter difficulty, all through natural language.
    46
    7
    -