Horoscope MCP Server

Horoscope MCP Server | Servidor MCP de Horóscopo

Inglés | Chino

Inglés

Un servidor de Model Context Protocol (MCP) que proporciona lecturas diarias de horóscopo y predicciones de fortuna. Este servidor se integra con una API de horóscopo para proporcionar lecturas detalladas de fortuna para todos los signos zodiacales.

Características

• Obtén lecturas de horóscopo para los 12 signos zodiacales
• Múltiples rangos de tiempo (hoy, mañana, semana, mes)
• Lecturas detalladas de fortuna que incluyen:
  • Fortuna general
  • Vida amorosa
  • Carrera profesional
  • Riqueza
  • Salud
• Números de la suerte, colores y signos compatibles
• Cosas que hacer y evitar
• Manejo limpio de errores y validación

Instalación

Instalación mediante Smithery

Para instalar Horoscope MCP Server para Claude Desktop automáticamente mediante Smithery:

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

Instalación manual

1. Clona el repositorio:

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

2. Instala las dependencias:

npm install

3. Compila el servidor:

npm run build

4. Añádelo a tu archivo de configuración de ajustes de MCP (la ubicación depende de tu sistema):

Para la extensión de Claude en VSCode:

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

Uso

El servidor proporciona una herramienta llamada get-horoscope que se puede utilizar para obtener lecturas de horóscopo.

Herramienta: get-horoscope

Parámetros:

• type (cadena): Signo zodiacal
  • Opciones: 'aries', 'taurus', 'gemini', 'cancer', 'leo', 'virgo', 'libra', 'scorpio', 'sagittarius', 'capricorn', 'aquarius', 'pisces'
• time (cadena): Rango de tiempo para la lectura
  • Opciones: 'today', 'nextday', 'week', 'month'

Ejemplo de uso:

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

Salida de ejemplo:

白羊座 2024年3月27日运势

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

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

[Additional sections...]

Chino

Servidor MCP de Horóscopo

Un servidor de Model Context Protocol (MCP) que proporciona lecturas de horóscopo y predicciones de fortuna. Este servidor se integra con una API de horóscopo para proporcionar lecturas detalladas de fortuna para los doce signos zodiacales.

Características

• Compatible con la consulta de horóscopos de los doce signos zodiacales
• Múltiples rangos de tiempo (hoy, mañana, semana, mes)
• Lecturas detalladas de fortuna que incluyen:
  • Fortuna general
  • Fortuna en el amor
  • Fortuna profesional
  • Fortuna financiera
  • Fortuna en la salud
• Números de la suerte, colores de la suerte y signos compatibles
• Guía de cosas que hacer y evitar hoy
• Manejo completo de errores y validación de datos

Pasos de instalación

Instalación mediante Smithery

Instala automáticamente Horoscope MCP Server para Claude Desktop mediante Smithery:

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

Instalación manual

1. Clona el repositorio:

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

2. Instala las dependencias:

npm install

3. Compila el servidor:

npm run build

4. Añádelo en el archivo de configuración de ajustes de MCP (la ubicación depende de tu sistema):

Configuración de la extensión VSCode Claude / Cursor:

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

Método de uso

El servidor proporciona la herramienta get-horoscope para obtener lecturas de horóscopo.

Herramienta: get-horoscope

Descripción de parámetros:

• type (cadena): Tipo de signo zodiacal
  • Opciones: 'aries' (Aries), 'taurus' (Tauro), 'gemini' (Géminis), 'cancer' (Cáncer), 'leo' (Leo), 'virgo' (Virgo), 'libra' (Libra), 'scorpio' (Escorpio), 'sagittarius' (Sagitario), 'capricorn' (Capricornio), 'aquarius' (Acuario), 'pisces' (Piscis)
• time (cadena): Rango de tiempo de la lectura
  • Opciones: 'today' (hoy), 'nextday' (mañana), 'week' (semana), 'month' (mes)

Ejemplo de uso:

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

Ejemplo de datos devueltos:

白羊座 2024年3月27日运势

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

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

[更多运势内容...]

Implementación técnica

Construido con las siguientes tecnologías:

• TypeScript
• Model Context Protocol SDK
• Node.js Fetch API
• Zod para la validación de parámetros

Manejo de errores

El servidor incluye un mecanismo completo de manejo de errores que cubre:

• Tipos de signo zodiacal no válidos
• Rangos de tiempo no válidos
• Fallos en las solicitudes a la API
• Errores de análisis de datos

Cuando se produce un error, se incluyen el código de error apropiado y mensajes descriptivos.

Guía de contribución

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Licencia

Licencia MIT: puedes usarlo libremente en tus propios proyectos.