Prokerala Astrology MCP

Prokerala Astrology MCP

由 Prokerala API 驱动的吠陀占星 MCP，通过命令行和 Web 界面提供占星服务，例如星座运势、Panchang 和配对分析。

功能

• 吠陀占星咨询
• 每日星座运势
• Panchang 详情
• Kundli 配对和契合度分析
• Manglik Dosha 分析
• 多种界面（CLI 和 Web UI）
• 支持多种印度语言

组件

1. 核心 MCP 服务（coremcp.py）

   • 主要服务实现
   • 处理 Prokerala API 集成
   • 提供占星工具和计算功能

2. 测试客户端（testclient.py）

   • 用于测试的命令行界面
   • 交互式聊天界面
   • 适用于开发和测试

3. Web UI（ui.py）

   • 基于 Chainlit 的 Web 界面
   • 用户友好的聊天界面
   • 实时响应

前提条件

• Python 3.12 或更高版本
• pip（Python 包管理器）
• 虚拟环境（推荐）

安装

1. 克隆代码仓库：

   git clone [email protected]:sajithamma/prokerala-mcp-server.git
   cd prokerala-mcp-server
   

2. 创建并激活虚拟环境：

   python3.12 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. 安装依赖：

   pip install -r requirements.txt
   

4. 创建 .env 文件并填入 Prokerala API 凭据：

   OPENAI_API_KEY=your_openai_api_key
   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   TOKEN_FILE_PATH=access_token.json
   

运行应用

1. 启动 MCP 服务

首先，启动主服务：

fastmcp run coremcp.py:mcp --transport sse

服务将在 http://localhost:8000 启动。

testclient.py

以下是在客户端代码中初始化服务的方法：

server = MCPServerSse(
    name="Prokerala SSE Server",
    params={
        "url": "http://localhost:8000/sse",
    },
)
await server.connect()  # Initialize the server connection

# Initialize the Agent with Prokerala tools
agent = Agent(
    name="Prokerala Assistant",
    instructions="""You are a vedic astrologer. Use Prokerala API tools to answer astrology questions. 
    Ask for place details to determine latitude/longitude. Use district/state if exact location is unknown.
    Only call tools when all required parameters are available.""",
    mcp_servers=[server],
    model_settings=ModelSettings(tool_choice="auto"),
)

2. 运行测试客户端

在新的终端中：

python testclient.py

测试客户端提供交互式命令行界面，你可以在其中：

• 获取每日星座运势
• 查看契合度
• 获取 Panchang 详情
• 等等……

用法示例：

Enter your message: get me today's horoscope
Sure, I can help with that. Could you please tell me your zodiac sign?
Enter your message: aries
[Horoscope details will be displayed]

3. 运行 Web UI（Chainlit）

在新的终端中：

chainlit run ui.py

Web 界面可通过 http://localhost:8000 访问，并提供：

• 现代化的聊天界面
• 实时响应
• 易于使用的占星服务界面

可用的占星服务

1. 每日星座运势

   • 获取个性化的每日预测
   • 适用于所有星座

2. Panchang

   • 每日占星详情
   • Tithi、nakshatra 和 yoga 信息

3. Kundli 配对

   • 契合度分析
   • Porutham 检查
   • Manglik Dosha 分析

4. 出生星盘分析

   • 详细的出生星盘
   • 行星位置
   • Dosha 分析

环境变量

应用使用以下环境变量：

• OPENAI_API_KEY：你的 OpenAI API 密钥
• CLIENT_ID：你的 Prokerala API 客户端 ID
• CLIENT_SECRET：你的 Prokerala API 客户端密钥
• TOKEN_FILE_PATH：存储访问令牌的路径

故障排查

1. 服务连接问题

   • 启动客户端或 UI 前，请确保 MCP 服务正在运行
   • 检查端口 8000 是否可用

2. API 身份验证错误

   • 检查 .env 文件中的 API 凭据是否正确
   • 检查令牌文件是否具有适当的权限

3. 日期格式问题

   • 使用正确的日期时间格式：YYYY-MM-DD HH:MM AM/PM
   • 对于 API 调用，系统会自动转换为 ISO 格式