Horoscope

Provides daily horoscope readings for all zodiac signs, with multiple time ranges and detailed fortune insights.

typescript

4

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 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": {
    "gbcui-horoscope-serve": {
      "command": "node",
      "args": [
        "/path/to/horoscope-serve/build/index.js"
      ]
    }
  }
}

You can run a dedicated MCP server that delivers daily horoscope readings and fortune-telling for all zodiac signs. This server connects to a horoscope API to provide detailed, time-based readings and handy extras like lucky numbers, colors, and compatibility, all accessible through a simple MCP tool.

How to use

To fetch horoscope readings, you will use the built-in MCP tool named get-horoscope. You specify the zodiac sign and the time range you want, such as today, tomorrow, a week, or a month. The response includes overall fortune, love, career, wealth, health, lucky numbers, colors, compatible signs, and guidance on things to do or avoid.

How to install

Prerequisites: ensure you have Node.js installed on your system. You may also want a code editor or terminal that supports running MCP configurations.

Install the MCP server using the provided local runtime setup
Build the server so it compiles to a runnable index. This step produces the build artifacts needed for execution.
Integrate the server into your MCP settings by pointing to the runtime entry file produced in the build step.

Below are concrete commands that reflect the setup described in the source content. Run them in your terminal in sequence.

# Step 1: Clone the project (if you haven't already)
git clone https://github.com/GBcui/horoscope-serve.git
cd horoscope-serve

# Step 2: Install dependencies
npm install

# Step 3: Build the server
npm run build

# Step 4: Add to MCP settings (example for a local stdio runtime)

Configuration and usage notes

The MCP server provides a local, stdio-based runtime. You run the server with a Node.js command that points to the built entry file.

{
  "mcpServers": {
    "horoscope": {
      "command": "node",
      "args": ["/path/to/horoscope-serve/build/index.js"]
    }
  }
}

Available tools

get-horoscope

Fetches horoscope readings for a specific zodiac sign and time range, returning detailed sections such as overall fortune, love, career, wealth, health, lucky numbers/colors, and compatibility.