星座 MCP 服务 (Star MCP)

一个功能完整的星座 MCP (Model Context Protocol) 服务，提供星座信息查询、运势分析、配对测试等功能。

功能特性

🌟 核心功能

• 星座信息查询: 获取12星座的详细信息，包括性格特征、守护星、元素等
• 今日运势: 提供爱情、事业、健康、财运、综合运势查询
• 星座配对: 分析两个星座的配对指数和关系
• 生日星座: 根据出生日期自动确定星座
• 星座列表: 获取所有星座的基本信息

🎯 支持的星座

• ♈ 白羊座 (Aries)
• ♉ 金牛座 (Taurus)
• ♊ 双子座 (Gemini)
• ♋ 巨蟹座 (Cancer)
• ♌ 狮子座 (Leo)
• ♍ 处女座 (Virgo)
• ♎ 天秤座 (Libra)
• ♏ 天蝎座 (Scorpio)
• ♐ 射手座 (Sagittarius)
• ♑ 摩羯座 (Capricorn)
• ♒ 水瓶座 (Aquarius)
• ♓ 双鱼座 (Pisces)

安装和运行

前置要求

• Node.js 18+
• npm 或 pnpm

安装依赖

cd star
npm install

运行服务

# 开发模式（自动重启）
npm run dev

# 生产模式
npm start

API 接口

1. 获取星座信息

{
  name: 'get_zodiac_info',
  arguments: {
    zodiac: '白羊座' // 或 'aries'
  }
}

2. 获取今日运势

{
  name: 'get_daily_horoscope',
  arguments: {
    zodiac: '狮子座',
    category: 'love' // love, career, health, wealth, luck
  }
}

3. 星座配对分析

{
  name: 'get_compatibility',
  arguments: {
    zodiac1: '白羊座',
    zodiac2: '狮子座'
  }
}

4. 根据生日查询星座

{
  name: 'get_zodiac_by_date',
  arguments: {
    month: 8,
    day: 15
  }
}

5. 获取所有星座列表

{
  name: 'get_all_zodiacs',
  arguments: {}
}

部署说明

本地部署

1. 克隆项目到本地
2. 安装依赖: npm install
3. 启动服务: npm start

Docker 部署

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["npm", "start"]

发布到 MCP 市场

1. 确保代码符合 MCP 规范
2. 添加适当的错误处理和日志
3. 编写完整的文档
4. 提交到 MCP 注册表

技术栈

• Node.js: 运行时环境
• MCP SDK: Model Context Protocol 官方 SDK
• ES Modules: 使用现代 JavaScript 模块系统

项目结构

star/
├── index.js          # 主服务文件
├── package.json      # 项目配置
├── README.md         # 项目文档
└── test.js           # 测试文件（可选）

开发指南

添加新功能

1. 在 tools 数组中定义新工具
2. 在 switch 语句中添加处理逻辑
3. 更新文档和测试

自定义数据

• 修改 zodiacData 对象添加星座信息
• 更新 horoscopeData 添加运势内容
• 调整 compatibilityData 修改配对规则

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

联系方式

如有问题或建议，请通过以下方式联系：

• 提交 GitHub Issue
• 发送邮件至项目维护者

---

注意: 本服务仅供娱乐参考，星座运势等内容不具有科学依据。