Horoscope MCP Server

Fornece leituras diárias de horóscopo e previsões para todos os 12 signos do zodíaco usando uma API de horóscopo.

GitHub
6
Experimente este MCPPatrocinado

Documentação

Servidor MCP de Horóscopo | 星座运势 MCP 服务器

English | 中文

English

Um servidor Model Context Protocol (MCP) que fornece leituras diárias de horóscopo e previsões. Este servidor integra-se a uma API de horóscopo para fornecer leituras detalhadas de fortuna para todos os signos do zodíaco. smithery badge Horoscope MCP Server

Recursos

  • Obtenha leituras de horóscopo para todos os 12 signos do zodíaco
  • Múltiplos períodos de tempo (hoje, amanhã, semana, mês)
  • Leituras detalhadas de fortuna, incluindo:
    • Fortuna geral
    • Vida amorosa
    • Carreira
    • Riqueza
    • Saúde
  • Números da sorte, cores e signos compatíveis
  • Coisas para fazer e evitar
  • Tratamento de erros e validação eficientes

Instalação

Instalando via Smithery

Para instalar o Horoscope MCP Server para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

  1. Clone o repositório:
git clone https://github.com/GBcui/horoscope-serve.git
cd horoscope-serve
  1. Instale as dependências:
npm install
  1. Compile o servidor:
npm run build
  1. Adicione ao seu arquivo de configuração de configurações MCP (a localização depende do seu sistema):

Para a extensão Claude do VSCode:

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

Uso

O servidor fornece uma ferramenta chamada get-horoscope que pode ser usada para buscar leituras de horóscopo.

Ferramenta: get-horoscope

Parâmetros:

  • type (string): Signo do zodíaco
    • Opções: 'aries', 'taurus', 'gemini', 'cancer', 'leo', 'virgo', 'libra', 'scorpio', 'sagittarius', 'capricorn', 'aquarius', 'pisces'
  • time (string): Período de tempo para a leitura
    • Opções: 'today', 'nextday', 'week', 'month'

Exemplo de uso:

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

Exemplo de saída:

白羊座 2024年3月27日运势

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

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

[Additional sections...]

Chinese

星座运势 MCP 服务器

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

功能特点

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

安装步骤

通过 Smithery 安装

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

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

手动安装

  1. 克隆仓库：
git clone https://github.com/GBcui/horoscope-serve.git
cd horoscope-serve
  1. 安装依赖：
npm install
  1. 构建服务器：
npm run build
  1. 在 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 许可证 - 您可以在自己的项目中自由使用。