Celestial Prophecy MCP Service | 星象预测服务

English

A Model Context Protocol (MCP) interface dedicated to dispensing horoscopic data and fortune-telling results. This service interfaces with an external celestial data source to furnish granular predictive narratives across the entire spectrum of zodiac signs.

Capabilities

Access predictions for all 12 astrological signs
Support for various temporal scopes (current day, subsequent day, weekly cycle, monthly cycle)
Comprehensive fate breakdown covering:
General outlook
Amorous prospects
Professional trajectory
Monetary fortune
Physical condition
Associated lucky digits, chromatic preferences, and high-compatibility signs
Guidance on favorable and unfavorable activities
Robust exception handling and input validation mechanisms

Deployment Instructions

Automated Deployment via Smithery

To automatically integrate the Celestial Prophecy MCP Service into your Claude Desktop environment using Smithery:

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

Manual Integration

Obtain the source repository:

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

Install necessary package dependencies:

bash npm install

Compile the service executable:

bash npm run build

Integrate the configuration into your MCP settings file (path varies by environment):

For VSCode Claude extension configuration:

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

Operational Guide

The exposed interface provides a callable function named fetch-celestial-reading for obtaining astrological reports.

Function: fetch-celestial-reading

Arguments required:

sign_id (string): Identifier for the zodiac sign
Enumeration: 'aries', 'taurus', 'gemini', 'cancer', 'leo', 'virgo', 'libra', 'scorpio', 'sagittarius', 'capricorn', 'aquarius', 'pisces'
period (string): Temporal scope of the divination
Enumeration: 'today', 'nextday', 'week', 'month'

Invocation Example:

typescript invoke_mcp_tool with: service_name: "astrology_engine" tool_name: "fetch-celestial-reading" parameters: { "sign_id": "aries", "period": "today" }

Example Result Snippet:

txt Aries Forecast for March 27, 2024

▎ General Outlook ★★★★☆ Today presents favorable circumstances; unexpected gains in professional endeavors are likely...

▎ Relationship Outlook ★★★★ If unattached, an appealing potential partner may enter your sphere...

[Further prognostic details...]

Chinese

星象预测 MCP 服务

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

功能特点

支持全部十二星座运势查询
多个时间范围（今日、明日、本周、本月）
详细的运势解读包括：
整体运势
爱情运势
事业运势
财运运势
健康运势
幸运数字、幸运颜色和速配星座
今日宜忌指南
完善的错误处理和数据验证

安装步骤

通过 Smithery 安装

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

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

手动安装

克隆仓库：

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

安装依赖：

bash npm install

构建服务器：

bash npm run build

在 MCP 设置配置文件中添加（具体位置取决于您的系统）：

VSCode Claude / Cursor 扩展配置：

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

使用方法

服务器提供了 fetch-celestial-reading 工具用于获取星座运势。

工具：fetch-celestial-reading

参数说明：

sign_id (字符串)：星座类型
可选值：'aries'（白羊座）, 'taurus'（金牛座）, 'gemini'（双子座）, 'cancer'（巨蟹座）, 'leo'（狮子座）, 'virgo'（处女座）, 'libra'（天秤座）, 'scorpio'（天蝎座）, 'sagittarius'（射手座）, 'capricorn'（摩羯座）, 'aquarius'（水瓶座）, 'pisces'（双鱼座）
period (字符串)：运势时间范围
可选值：'today'（今日）, 'nextday'（明日）, 'week'（本周）, 'month'（本月）

使用示例：

typescript invoke_mcp_tool with: service_name: "astrology_engine" tool_name: "fetch-celestial-reading" parameters: { "sign_id": "aries", "period": "today" }

返回数据示例：

txt 白羊座 2024年3月27日运势

▎ 整体运势 ★★★★☆ 今天的运势相当不错，工作上会有意外收获...

▎ 爱情运势 ★★★★ 单身的你可能会遇到心仪的对象...

[更多运势内容...]

技术实现

使用以下技术构建：

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

错误处理

服务器包含完善的错误处理机制，涵盖：

无效的星座类型
无效的时间范围
API 请求失败
数据解析错误

错误返回时会包含适当的错误代码和描述性消息。

贡献指南

欢迎提交贡献！请随时提交 Pull Request。

许可证

MIT 许可证 - 您可以在自己的项目中自由使用。

WIKIPEDIA: Business management tools are all the systems, applications, controls, calculating solutions, methodologies, etc. used by organizations to be able to cope with changing markets, ensure a competitive position in them and improve business performance.

== Overview == There are tools related to each organization's department which can be classified for each aspect of management. For example: planning tools, process tools, records tools, employee related tools, decision making tools, control tools, etc. A classification by function would consider these general aspects:

Tools used for data input and validation in any department. Tools used for controlling and improving business processes. Tools used for data consolidation and decision making. Nowadays, management tools have evolved dramatically in the last decade thanks to fast technology advances, so fast that it is difficult to select the best business tools for any situation in any company. This is caused by a never-ending fight for lower costs and increase sales, the willingness for understanding the customers' needs, and the fight for delivering the products that meet their need in the way they require. Under this scenario, managers should take a strategic attitude to business management tools instead of going for the latest tool. Usually, managers rely on the tools without any adaptation which leads to an unstable situation. Business management tools should be selected carefully, and then adapted to the organization needs and not the other way around.

== Most used == In 2013, a survey conducted by Bain & Company showed how business tools are used around the globe. These tools reflect how their outcomes contribute to each region's needs, considering the downfall and companies' market situation. The top ten includes:

Strategic planning Customer relationship management Employee engagement surveys Benchmarking Balanced scorecard Core competency Outsourcing Change management programs Supply chain management Mission statement and vision statement Market segmentation Total quality management

== Software application for businesses == Software or collection of computer programs used by business users to carry out various business operations is referred to as business software (or a business application). These business applications are used to boost output, gauge output, and carry out various other company tasks precisely. It started with management information systems and extended into enterprise resource planning systems. Then customer relationship management was added to the solution and finally the whole package moved into the cloud business management space. Although there is an actual correlation between IT efforts and the organizations' performance, two elements are key to add value to the sum; these are the implementation's effectiveness and the proper tools selections and adaptation process.

== Tools for SMEs == The tools focused on SMEs are important because they provide ways to save m