Prokerala Astrology MCP

Prokerala Ast​rology MCP

Prokerala API を利用したヴェーダ占星術 API 向けの MCP です。コマンドラインとウェブインターフェースの両方から、ホロスコープ、パンチャン、相性分析などの占星術サービスを提供します。

Features

• ヴェーダ占星術の相談
• 毎日のホロスコープ鑑定
• パンチャンの詳細情報
• クンドリーのマッチングと相性分析
• マンガリク・ドーシャ分析
• 複数のインターフェース（CLI と Web UI）
• 複数のインド言語に対応

Components

1. コア MCP サーバー（coremcp.py）

   • メインサーバーの実装
   • Prokerala API との連携を処理
   • 占星術ツールと計算機能を提供

2. テストクライアント（testclient.py）

   • テスト用のコマンドラインインターフェース
   • 対話型のチャットインターフェース
   • 開発とテストに便利

3. Web UI（ui.py）

   • Chainlit ベースのウェブインターフェース
   • 使いやすいチャットインターフェース
   • リアルタイム応答

Prerequisites

• Python 3.12 以上
• pip（Python パッケージマネージャー）
• 仮想環境（推奨）

Installation

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. Prokerala API の認証情報を記載した .env ファイルを作成します：

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

Running the Application

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

テストクライアントでは、次の操作を行える対話型コマンドラインインターフェースを利用できます：

• 毎日のホロスコープを取得する
• 相性を確認する
• パンチャンの詳細情報を取得する
• その他

使用例：

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

ウェブインターフェースは http://localhost:8000 で利用でき、次の機能を提供します：

• モダンなチャットインターフェース
• リアルタイム応答
• すべての占星術サービスで使いやすい形式

Available Astrological Services

1. 毎日のホロスコープ

   • 個人に合わせた毎日の予測を取得
   • すべての星座に対応

2. パンチャン

   • 毎日の占星術情報
   • ティティ、ナクシャトラ、ヨーガの情報

3. クンドリーのマッチング

   • 相性分析
   • ポルタムの確認
   • マンガリク・ドーシャ分析

4. 出生図分析

   • 詳細な出生図
   • 惑星の位置
   • ドーシャ分析

Environment Variables

アプリケーションでは、次の環境変数を使用します：

• OPENAI_API_KEY：OpenAI API キー
• CLIENT_ID：Prokerala API のクライアント ID
• CLIENT_SECRET：Prokerala API のクライアントシークレット
• TOKEN_FILE_PATH：アクセストークンの保存先

Troubleshooting

1. サーバー接続の問題

   • クライアントまたは UI を起動する前に、MCP サーバーが実行中であることを確認してください
   • ポート 8000 が利用可能か確認してください

2. API 認証エラー

   • .env ファイルの API 認証情報を確認してください
   • トークンファイルに適切な権限が設定されているか確認してください

3. 日付形式の問題

   • 正しい日時形式を使用してください：YYYY-MM-DD HH:MM AM/PM
   • API 呼び出しでは、システムが自動的に ISO 形式に変換します