Prokerala Astrology MCP
About
MCP (Model Context Protocol) Server for ProKerala Astrology API
Explore
- 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
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
- Python 3.12 or higher
- pip (Python package manager)
- Virtual environment (recommended)
The application uses the following environment variables:
- OPENAI_API_KEY: Your OpenAI API key
- CLIENT_ID: Your Prokerala API client ID
- CLIENT_SECRET: Your Prokerala API client secret
- TOKEN_FILE_PATH: Path to store the access token
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"),
)
```
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"
]
}
}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 [email protected]: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.
