星座运势 MCP 服务器

本项目是一个实现了 Model Context Protocol (MCP) 的服务器，专注于提供星座运势查询功能。通过此服务器，LLM 应用可以轻松获取用户指定星座在不同时间范围内的运势信息，为用户提供更加个性化和 context-aware 的服务。

主要功能点

提供全面的星座运势信息： 支持十二星座的运势查询，包括整体运势、爱情、事业、财富和健康等方面。
支持多时间范围查询： 用户可以查询今日、明日、本周和本月的运势。
详细的运势解读： 除了运势评分，还提供详细的运势文字描述、幸运数字、幸运颜色、速配星座以及今日宜忌等信息。
基于 MCP 协议： 采用标准的 MCP 协议，易于集成到各种支持 MCP 协议的 LLM 应用中。

安装步骤

克隆仓库：

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

安装依赖： 确保已安装 Node.js 和 npm，然后运行以下命令安装项目依赖：
```
npm install
```
构建服务器： 运行以下命令构建项目，生成可执行的 JavaScript 文件：
```
npm run build
```

服务器配置

要将此 MCP 服务器添加到 MCP 客户端（例如 VSCode Claude 扩展），您需要配置服务器的启动命令。以下是配置示例，请根据您的实际情况修改路径：

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

配置参数说明：

'server name': 'horoscope' (服务器名称，您可以自定义，用于在客户端中引用)
'command': 'node' (运行服务器的命令，这里使用 Node.js)
'args': '["/path/to/horoscope-serve/build/index.js"]' (命令参数，指向构建后的服务器入口文件 'index.js'，请务必替换为您的实际文件路径)

基本使用方法

服务器启动后，LLM 应用可以通过 MCP 协议调用 'get_horoscope' 工具来获取星座运势。

工具名称: 'get_horoscope'

工具参数:

'type' (字符串, 必填): 要查询的星座类型，可选值包括：'aries'（白羊座）, 'taurus'（金牛座）, 'gemini'（双子座）, 'cancer'（巨蟹座）, 'leo'（狮子座）, 'virgo'（处女座）, 'libra'（天秤座）, 'scorpio'（天蝎座）, 'sagittarius'（射手座）, 'capricorn'（摩羯座）, 'aquarius'（水瓶座）, 'pisces'（双鱼座）。
'time' (字符串, 必填): 运势时间范围，可选值包括：'today'（今日）, 'nextday'（明日）, 'week'（本周）, 'month'（本月）。

使用示例 (在支持 MCP 工具调用的 LLM 应用中):

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

工具返回示例 (文本格式):

白羊座 2024年3月27日运势

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

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

[更多运势内容...]

通过 'get_horoscope' 工具，LLM 应用可以根据用户指令或上下文信息，动态查询并利用星座运势数据，为用户提供更丰富和有趣的应用体验。

关键词

星座运势 MCP 服务器

主要功能点

安装步骤

服务器配置

基本使用方法

信息