home / mcp / horoscope mcp server
Provides daily horoscope readings for all zodiac signs, with multiple time ranges and detailed fortune insights.
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.
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.
Prerequisites: ensure you have Node.js installed on your system. You may also want a code editor or terminal that supports running MCP configurations.
1) Install the MCP server using the provided local runtime setup
2) Build the server so it compiles to a runnable index. This step produces the build artifacts needed for execution.
3) 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)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"]
}
}
}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.