Horoscope MCP Server

by gbcui

4 stars

Not rated

GitHub

About

Provides astrological horoscope functionality with tools for generating personalized predictions and insights based on zodiac signs and celestial positions.

Details

Author: gbcui
Repository: GBcui/horoscope-serve
GitHub stars: 4
License: MIT License
Categories: Other, API, Productivity, Developer Tools, Design, AI, Search, Infrastructure, Frontend
Tags: #entertainment

- Get horoscope readings for all 12 zodiac signs
- Multiple time ranges (today, tomorrow, week, month)
- Detailed fortune readings including:
- Overall fortune
- Love life
- Career
- Wealth
- Health
- Lucky numbers, colors, and compatible signs
- Things to do and avoid
- Clean error handling and validation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Horoscope MCP Server

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/horoscope-serve/build/index.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

From the repository

The server provides a tool called get-horoscope that can be used to fetch horoscope readings.

To install Horoscope MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @GBcui/horoscope-serve --client claude

1. Clone the repository:

git clone https://github.com/GBcui/horoscope-serve.git
cd horoscope-serve

2. Install dependencies:

npm install

3. Build the server:

npm run build

4. Add to your MCP settings configuration file (location depends on your system):

For VSCode Claude extension:

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

`get-horoscope`

Fetch horoscope readings for a specific zodiac sign and time range. Parameters: type (string): Zodiac sign (options: 'aries', 'taurus', 'gemini', 'cancer', 'leo', 'virgo', 'libra', 'scorpio', 'sagittarius', 'capricorn', 'aquarius', 'pisces'), time (string): Time range for the reading (options: 'today', 'nextday', 'week', 'month').

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "horoscope mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/horoscope-serve/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Linux

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

Macos

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

Windows

{
    "cwd": "",
    "env": [],
    "args": [
        "/c",
        "node",
        "/path/to/horoscope-serve/build/index.js"
    ],
    "shell": false,
    "command": "cmd"
}

A Model Context Protocol (MCP) server that provides daily horoscope readings and fortune telling. This server integrates with a horoscope API to provide detailed fortune readings for all zodiac signs.

- Get horoscope readings for all 12 zodiac signs
- Multiple time ranges (today, tomorrow, week, month)
- Detailed fortune readings including:

- Overall fortune
- Love life
- Career
- Wealth
- Health

To install Horoscope MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @GBcui/horoscope-serve --client claude

git clone https://github.com/GBcui/horoscope-serve.git cd horoscope-serve

- Add to your MCP settings configuration file (location depends on your system):

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

The server provides a tool calledget-horoscopethat can be used to fetch horoscope readings.

- type(string): Zodiac sign

- Options: 'aries', 'taurus', 'gemini', 'cancer', 'leo', 'virgo', 'libra', 'scorpio', 'sagittarius', 'capricorn', 'aquarius', 'pisces'

- Options: 'today', 'nextday', 'week', 'month'

use_mcp_tool with: server_name: "horoscope" tool_name: "get-horoscope" arguments: { "type": "aries", "time": "today" }

白羊座 2024年3月27日运势 ▎ 整体运势 ★★★★☆ 今天的运势相当不错，工作上会有意外收获... ▎ 爱情运势 ★★★★ 单身的你可能会遇到心仪的对象... [Additional sections...]

一个提供星座运势和运程预测的 Model Context Protocol (MCP) 服务器。该服务器集成了星座运势 API，为全部十二星座提供详细的运势解读。

- 支持全部十二星座运势查询
- 多个时间范围（今日、明日、本周、本月）
- 详细的运势解读包括：

- 整体运势
- 爱情运势
- 事业运势
- 财运运势
- 健康运势

通过 Smithery自动为 Claude Desktop 安装 Horoscope MCP 服务器：

npx -y @smithery/cli install @GBcui/horoscope-serve --client claude

git clone https://github.com/GBcui/horoscope-serve.git cd horoscope-serve

{ "mcpServers": { "horoscope": { "command": "node", "args": ["/path/to/horoscope-serve/build/index.js"] // 替换为实际路径 } } }

- type(字符串)：星座类型

- 可选值：'aries'（白羊座）, 'taurus'（金牛座）, 'gemini'（双子座）, 'cancer'（巨蟹座）, 'leo'（狮子座）, 'virgo'（处女座）, 'libra'（天秤座）, 'scorpio'（天蝎座）, 'sagittarius'（射手座）, 'capricorn'（摩羯座）, 'aquarius'（水瓶座）, 'pisces'（双鱼座）

- 可选值：'today'（今日）, 'nextday'（明日）, 'week'（本周）, 'month'（本月）

use_mcp_tool with: server_name: "horoscope" tool_name: "get-horoscope" arguments: { "type": "aries", "time": "today" }

白羊座 2024年3月27日运势 ▎ 整体运势 ★★★★☆ 今天的运势相当不错，工作上会有意外收获... ▎ 爱情运势 ★★★★ 单身的你可能会遇到心仪的对象... [更多运势内容...]

- TypeScript
- Model Context Protocol SDK
- Node.js Fetch API
- Zod 用于参数验证

Comprehensive astrology MCP backed by the AstroWay Calculation API — natal, synastry, transits, Vedic dashas (Vimshottari/Yogini/Ashtottari/Kalachakra), Tarot (Rider-Waite-Smith / Marseille / Lenormand), Numerology, Human Design, AI horoscopes. Sub-arcsecond Swiss Ephemeris precision. 10 000 free credits/month, no card required. Install: npx @astroway/mcp

An MCP server for accessing Bazi (Chinese astrology) data, requiring an API key.

Access real-time entertainment data and personal viewing history from the Trakt.tv API.

Search for movies and manage playlists on your Plex Media Server using the Plex API.

MCP server for VRChat friends, worlds, groups, events, notifications, status, avatars, and VRCX history.

Fetches daily Wordle solutions using the official Wordle API.

Enable fast, free real-time web search and access premium data from trusted media brands for news, financial markets, sports, entertainment, weather, and more.

Interact with the Marvel Developer API to access data on characters and comics.

Integrates with The Movie Database (TMDB) API, allowing AI assistants to search for movies, retrieve details, and generate related content.

Discover events, venues, and attractions using the Ticketmaster Discovery API.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get-horoscope

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

GitLab

Reactive Resume

`get-horoscope`