absher

The Absher MCP Server provides eight tools to interact with authentication, user data, service discovery and execution for Absher-related government services. Clients can connect using any MCP-compatible interface; the server communicates via standard MCP JSON strings over stdio. Tools for authentication include verify_national_id to check a national ID, get_security_questions to fetch verification questions, and verify_security_answers to validate responses. The single user data tool, get_user_data, returns a complete user profile. For service orchestration, get_service_requirements reveals required fields for a chosen service, after which you can execute the service with one of three actions: renew_passport, get_traffic_fines, or book_appointment. Each tool is designed to be stateless and driven by a combination of user data (from mock_data or a real DB) and user input collected through the client flow.

To use the server, start it in standalone or MCP client mode, then issue the appropriate tool calls in sequence as dictated by your workflow. Example sequences include identity verification, data loading, and either renewal, fines lookup or appointment booking. The responses are returned as JSON strings, with Arabic field values and English function names to maintain clear integration with Arabic-speaking users and multilingual clients. Ensure your MCP client is configured to send the necessary parameters (e.g., national_id, questions, answers, service_name, etc.) as shown in the tool usage examples in the README.

Prerequisites:

• Python 3.8+ installed on your system
• Access to the repository containing absher_server.py and mock_data.py
• pip available for installing dependencies

Step-by-step installation:

1. Clone the repository (or download the source): git clone https://github.com/your-org/absher-mcp-server.git cd absher-mcp-server

2. Create and activate a virtual environment (optional but recommended): python -m venv venv source venv/bin/activate # on Windows use: venv\Scripts\activate

3. Install dependencies: pip install -r requirements.txt

4. Run the server (standalone or with MCP client):

   • Standalone for testing: python absher_server.py
   • With MCP client (recommended): python absher_server.py # server will listen for MCP client connections via stdio

5. If you need to configure the client, prepare the MCP config file as shown in the mcp_config section and point your client to the server via the standard MCP transport (stdio in this setup).

Notes and tips:

• All tool responses are JSON strings to simplify parsing by MCP clients.
• The server uses mock_data.py for test users, fines, and service requirements. Replace or extend this with a real database as needed.
• Arabic language is used for user-facing content, while function names remain in English for consistency with MCP clients.
• If you run into path issues, ensure the path in the mcp_config matches the location of absher_server.py.
• Ensure the Python environment has access to the necessary dependencies listed in requirements.txt.
• The server is designed to be stateless; ensure you manage user sessions and state in your client or a separate storage layer if needed.