
Horoscope MCP Server
Fetch daily horoscope readings and detailed fortune insights for all zodiac signs. Get personalized predictions on love, career, health, and more, tailored to your zodiac sign and time range. Enhance your decision-making with lucky numbers and compatibility advice.
Installation
Installing for Claude Desktop
Option 1: One-Command Installation
npx mcpbar@latest install GBcui/horoscope-serve -c claude
This command will automatically install and configure the Horoscope MCP Server MCP server for your selected client.
Option 2: Manual Configuration
Run the command below to open your configuration file:
npx mcpbar@latest edit -c claude
After opening your configuration file, copy and paste this configuration:
View JSON configuration
{
"mcpServers": {
"Horoscope MCP Server": {
"command": "node",
"args": [
"/path/to/horoscope-serve/build/index.js"
]
}
}
}
Horoscope MCP Server | 星座运势 MCP 服务器
English
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.
Features
- 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
Installation
- Clone the repository:
git clone https://github.com/GBcui/horoscope-serve.git
cd horoscope-serve
- Install dependencies:
npm install
- Build the server:
npm run build
- 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"]
}
}
}
Usage
The server provides a tool called get-horoscope
that can be used to fetch horoscope readings.
Tool: get-horoscope
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'
Example usage:
use_mcp_tool with:
server_name: "horoscope"
tool_name: "get-horoscope"
arguments: {
"type": "aries",
"time": "today"
}
Sample output:
白羊座 2024年3月27日运势
▎ 整体运势 ★★★★☆
今天的运势相当不错,工作上会有意外收获...
▎ 爱情运势 ★★★★
单身的你可能会遇到心仪的对象...
[Additional sections...]
Chinese
星座运势 MCP 服务器
一个提供星座运势和运程预测的 Model Context Protocol (MCP) 服务器。该服务器集成了星座运势 API,为全部十二星座提供详细的运势解读。
功能特点
- 支持全部十二星座运势查询
- 多个时间范围(今日、明日、本周、本月)
- 详细的运势解读包括:
- 整体运势
- 爱情运势
- 事业运势
- 财运运势
- 健康运势
- 幸运数字、幸运颜色和速配星座
- 今日宜忌指南
- 完善的错误处理和数据验证
安装步骤
- 克隆仓库:
git clone https://github.com/GBcui/horoscope-serve.git
cd horoscope-serve
- 安装依赖:
npm install
- 构建服务器:
npm run build
- 在 MCP 设置配置文件中添加(具体位置取决于您的系统):
VSCode Claude / Cursor 扩展配置:
{
"mcpServers": {
"horoscope": {
"command": "node",
"args": ["/path/to/horoscope-serve/build/index.js"] // 替换为实际路径
}
}
}
使用方法
服务器提供了 get-horoscope
工具用于获取星座运势。
工具:get-horoscope
参数说明:
type
(字符串):星座类型- 可选值:'aries'(白羊座), 'taurus'(金牛座), 'gemini'(双子座), 'cancer'(巨蟹座), 'leo'(狮子座), 'virgo'(处女座), 'libra'(天秤座), 'scorpio'(天蝎座), 'sagittarius'(射手座), 'capricorn'(摩羯座), 'aquarius'(水瓶座), 'pisces'(双鱼座)
time
(字符串):运势时间范围- 可选值:'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 用于参数验证
错误处理
服务器包含完善的错误处理机制,涵盖:
- 无效的星座类型
- 无效的时间范围
- API 请求失败
- 数据解析错误
错误返回时会包含适当的错误代码和描述性消息。
贡献指南
欢迎提交贡献!请随时提交 Pull Request。
许可证
MIT 许可证 - 您可以在自己的项目中自由使用。
Stars
2Forks
2Last commit
3 months agoRepository age
3 monthsLicense
MIT
Auto-fetched from GitHub .
MCP servers similar to Horoscope MCP Server:

Stars
Forks
Last commit

Stars
Forks
Last commit

Stars
Forks
Last commit