🚀 星座运势 MCP 服务器
星座运势 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 扩展：
{
"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 许可证，您可以在自己的项目中自由使用。