Fortune

Provides tarot readings and horoscope calculations via MCP for on-demand fortune-telling features.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "takada-at-fortune_mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/abs/path/to/fortune_mcp",
        "fortune-mcp-server"
      ]
    }
  }
}

You set up this MCP server to offer two practical tools: drawing tarot cards and calculating horoscopes for a given time and location. It’s useful for apps or assistants that want playful fortune-telling features or astrology-based insights delivered on demand.

How to use

After you start the server, you can access two MCP tools for end users: draw_tarot and get_horoscope. The draw_tarot tool draws a specified number of tarot cards and returns the interpretation. The get_horoscope tool computes a horoscope for a given datetime and location, with options to randomize the datetime and to supply latitude and longitude.

How to install

# Prerequisites
# Ensure you have a working runtime environment for MCP servers (uvx and uv are used here).

# 1) Install the Fortune MCP Server from its source
uvx --from git+https://github.com/takada-at/fortune_mcp fortune-mcp-server

# 2) Local install (alternative)
git clone https://github.com/takada-at/fortune_mcp.git
cd fortune_mcp
uv sync
uv run --directory /abs/path/to/fortune_mcp fortune-mcp-server

Configuration and runtime details

The Fortune MCP Server exposes two core tools via the MCP interface. You don’t need to modify code to start using them; you only need to ensure the server is running and then call the respective tools from your MCP client with the required parameters.

Known tools and parameters

draw_tarot
count (optional): number of cards to draw (1–10). Default is 3 if not provided.
get_horoscope
datetime (optional): calculation time in YYYY-MM-DD HH:MM:SS format. If omitted, uses the current time.
random (optional): if true, generates a random datetime for the horoscope (default: false).
latitude (optional): geographic latitude. Default is Tokyo, 35.6895.
longitude (optional): geographic longitude. Default is Tokyo, 139.6917.

Notes and tips

If you are deploying this for a client app, consider caching horoscopes for common time zones and locations to improve response times. The server’s horoscope logic uses astro calculations; for offline or offline-like environments, you can adjust input parameters to simulate various times and places.

Available tools

draw_tarot

Draws a specified number of tarot cards and returns the reading.

get_horoscope

Calculates a horoscope for a given datetime and location, with options for randomization and coordinates.