Horoscope

🚀 星座运势 MCP 服务器

星座运势 MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务，它集成了星座运势 API，能为全部十二星座提供详细的运势解读，支持多时间范围查询，满足用户对星座运势的多样化需求。

🚀 快速开始

本服务器提供了便捷的安装和使用方式，让你能迅速获取星座运势信息。

✨ 主要特性

• 全星座覆盖：支持全部十二星座的运势查询。
• 多时间范围：提供今日、明日、本周、本月等多个时间范围的运势查询。
• 详细运势解读：包含整体运势、爱情运势、事业运势、财运运势、健康运势等方面。
• 特色信息：提供幸运数字、幸运颜色和速配星座。
• 宜忌指南：为用户提供星座运势的宜忌建议。
• 完善的错误处理：具备完善的错误处理和数据验证机制。

📦 安装指南

1. 克隆仓库：

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

2. 安装依赖：

npm install

3. 构建服务器：

npm run build

4. 添加到 MCP 设置配置文件（具体位置取决于系统）：

对于 VSCode Claude 扩展：

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

💻 使用示例

基础用法

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

高级用法

在基础用法上，你可以根据需求灵活组合 type 和 time 参数，以获取不同星座在不同时间范围的运势信息。例如，你可以查询金牛座本周的运势：

use_mcp_tool with:
server_name: "horoscope"
tool_name: "get_horoscope"
arguments: {
  "type": "taurus",
  "time": "week"
}

参数说明

• type：星座类型，支持以下值：
  • "aries"（白羊座）
  • "taurus"（金牛座）
  • "gemini"（双子座）
  • "cancer"（巨蟹座）
  • "leo"（狮子座）
  • "virgo"（处女座）
  • "libra"（天秤座）
  • "scorpio"（天蝎座）
  • "sagittarius"（射手座）
  • "capricorn"（摩羯座）
  • "aquarius"（水瓶座）
  • "pisces"（双鱼座）
• time：时间范围，支持以下值：
  • "today"（今日）
  • "tomorrow"（明日）
  • "week"（本周）
  • "month"（本月）

返回数据示例

白羊座 2024年3月27日运势

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

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

[更多运势内容...]

🔧 技术细节

本服务器使用以下技术构建：

• TypeScript：提供类型安全的开发体验。
• Model Context Protocol SDK：实现 MCP 协议的相关功能。
• Node.js Fetch API：用于与星座运势 API 进行数据交互。
• Zod：用于参数验证，确保输入数据的有效性。

📚 详细文档

错误处理

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

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

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

贡献指南

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

📄 许可证

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