Prokerala Astrology MCP
About
MCP (Model Context Protocol) Server for ProKerala Astrology API
Details
- Author
- sajithamma
- Downloads
- 450
- Categories
- Other, API
Jump to
- Vedic astrology consultations and daily horoscope readings
- Panchang details (tithi, nakshatra, yoga)
- Kundli matching and compatibility analysis
- Manglik Dosha analysis
- Multiple interfaces: CLI and Web UI (Chainlit)
- Support for multiple Indian languages
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Prokerala Astrology MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, set up a Python 3.12+ virtual environment, install dependencies, and create a .env file with your Prokerala API credentials and OpenAI API key. Start the server with fastmcp run coremcp.py:mcp --transport sse, then run the test client (python testclient.py) or the Chainlit web UI (chainlit run ui.py).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"prokerala astrology mcp": {
"prokerala-mcp-server": {
"command": "python",
"args": [
"testclient.py"
]
}
}
}
}McpServers
{
"prokerala-mcp-server": {
"command": "python",
"args": [
"testclient.py"
]
}
}Prokerala Astrology MCP
MCP for Vedic astrology API powered by Prokerala API, providing astrological services like horoscopes, panchang, and compatibility analysis through both command-line and web interfaces.
Features
- Vedic astrology consultations
- Daily horoscope readings
- Panchang details
- Kundli matching and compatibility analysis
- Manglik Dosha analysis
- Multiple interfaces (CLI and Web UI)
- Support for multiple Indian languages
Components
1. Core MCP Server (coremcp.py)
- Main server implementation
- Handles Prokerala API integration
- Provides astrological tools and calculations
2. Test Client (testclient.py)
- Command-line interface for testing
- Interactive chat-based interface
- Useful for development and testing
3. Web UI (ui.py)
- Chainlit-based web interface
- User-friendly chat interface
- Real-time responses
Prerequisites
- Python 3.12 or higher
- pip (Python package manager)
- Virtual environment (recommended)
Installation
1. Clone the repository:
git clone git@github.com:sajithamma/prokerala-mcp-server.git
cd prokerala-mcp-server
2. Create and activate a virtual environment:
python3.12 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
3. Install dependencies:
pip install -r requirements.txt
4. Create a .env file with your Prokerala API credentials:
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. Start the MCP Server
First, start the main server:
fastmcp run coremcp.py:mcp --transport sse
The server will start on http://localhost:8000
testclient.py
Here's how to initialize the server in your client code:
```python
server = MCPServerSse(
name="Prokerala SSE Server",
params={
"url": "http://localhost:8000/sse",
},
)
await server.connect() # Initialize the server connection
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
