MCP Ev Assistant Server

🚀 MCP Electric Vehicle Assistant Server

A powerful server implementation for managing electric vehicle (EV) charging stations, trip planning, and resource management. This server provides comprehensive tools and APIs for EV-related services.

🚀 Quick Start

The MCP Electric Vehicle Assistant Server is a robust solution designed to streamline the management of electric vehicle charging stations, plan trips, and handle resource management. It offers a wide range of features and APIs to support EV-related services.

✨ Features

1. Electric Vehicle Charging Station Services

• Charging Station Location: Find nearby EV charging stations based on location and preferences.
• Socket Type Filtering: Search for specific charging socket types (CCS, CHAdeMO, Type 2, etc.).
• Distance-Based Search: Specify a search radius to find charging stations.

2. Trip Planning

• Route Planning: Plan driving routes suitable for electric vehicles.
• Charging Station Stop Integration: Automatically include necessary charging stops.
• Range Consideration: Take into account the vehicle's range and current battery level.

3. Resource Management

• PDF Document Management: Handle PDF files in the /Data directory.
• Resource Subscription System: Support subscription and unsubscription of resources.

4. Error Handling

• Comprehensive Error Logging: Record detailed error information.
• Multi-Level Fallback Mechanism: Provide multiple backup methods in PDF processing.
• Input Validation: Use Pydantic models for data validation.
• Graceful Resource Absence Handling

📦 Installation

Clone the Repository

git clone https://github.com/yourusername/ev-assistant.git
cd ev-assistant

Install Dependencies

pip install -r requirements.txt

Start the Server

python main.py

📚 Documentation

Configuration

Environment Variables

Set the following environment variables to configure the server behavior:

• EV_ASSISTANT_API_KEY: API access key
• EV_ASSISTANT_DATA_PATH: Path to the PDF resource directory

Example Configuration File

# config.py
API_KEY = "your_api_key_here"
DATA_DIRECTORY = "/path/to/data/files"

Usage

Adding New Tools

1. Define the tool schema in core.schemas.
2. Implement the tool functionality in agentTools.
3. Add the tool to handle_list_tools().
4. Implement the tool processing logic in handle_call_tool().

Example Code Snippet

# tools_example.py
def new_tool_function():
    # Processing logic
    pass

# Register the tool in handle_list_tools
TOOLS.append(new_tool_function)

API Reference

Charging Station Search Interface

async def search_charging_stations(location: str, radius: int = 50):
    """
    Find nearby charging stations based on location and radius.
    
    Parameters:
        location (str): Search location
        radius (int, optional): Search radius in kilometers, default is 50 km
        
    Returns:
        list: A list containing detailed information about charging stations
    """
    pass

Resource Subscription API

async def subscribe_resource(resource_uri: str):
    """
    Subscribe to the specified resource.
    
    Parameters:
        resource_uri (str): URI of the resource to subscribe to
        
    Returns:
        bool: A boolean indicating whether the subscription was successful
    """
    pass

async def unsubscribe_resource(resource_uri: str):
    """
    Unsubscribe from the specified resource.
    
    Parameters:
        resource_uri (str): URI of the resource to unsubscribe from
        
    Returns:
        bool: A boolean indicating whether the unsubscription was successful
    """
    pass

Resource Management

PDF Resource Processing

• Automatically discover PDF files in the /Data directory.
• Support multiple text extraction methods.
• Handle resource updates and version control.

Example Subscription Operations

# Subscribe to a resource
await client.subscribe_resource("file:///pdf/ev_manual")

# Unsubscribe from a resource
await client.unsubscribe_resource("file:///pdf/ev_manual")

Error Handling

Common Error Codes

• 401 Unauthorized: Unauthorized access
• 503 Service Unavailable: Service unavailable
• 429 Too Many Requests: Too many requests

Log Example

INFO: Server started on port 8000
DEBUG: Successfully parsed configuration file
ERROR: Failed to connect to database: connection refused

Development

Creating a New Feature Module

1. Create a new Python file in the core directory.
2. Implement the required functionality.
3. Update __init__.py to include the new module.
4. Test the new feature and fix any discovered errors.

Example Test Code

def test_new_feature():
    assert new_function() == expected_output

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some Amazing Feature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is released under the MIT License. See the LICENSE file for details.