MCP UseCase Function Server

A Model Context Protocol (MCP) server that triggers functions based on specific usecases, built with Python and FastMCP.

Features

• UseCase-based Function Triggering: Execute functions based on predefined usecases

• stdio Transport: Compatible with Claude Desktop

• Multiple Function Types: Data analysis, text processing, calculations, file operations, and web requests

• Easy Integration: Simple setup for Claude Desktop

Available Usecases

1. data_analysis - Analyze numerical data (mean, max, min, count)

2. text_processing - Process text (uppercase, lowercase, word count, char count)

3. calculation - Mathematical operations (add, multiply, divide)

4. file_operation - File handling operations (info, simulation)

5. web_request - Web request simulation (GET, POST, etc.)

Installation

1. Install dependencies:

python3 -m pip install -r requirements.txt

2. Test the server:

python3 test_client.py

Claude Desktop Integration

Add this configuration to your Claude Desktop settings:

macOS

Edit: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Edit: %APPDATA%/Claude/claude_desktop_config.json

Linux

Edit: ~/.config/claude/claude_desktop_config.json

Add the server configuration:

{
  "mcpServers": {
    "usecase-function-server": {
      "command": "python3",
      "args": ["/path/to/your/mcp_server.py"],
      "env": {}
    }
  }
}

Replace /path/to/your/mcp_server.py with the actual path to your server file.

Usage

Available Tools

1. trigger_function_by_usecase(usecase, parameters)

   • Execute a function based on usecase

   • Returns result with success status

2. list_available_usecases()

   • Get all available usecases

   • Returns array of usecase names

3. get_usecase_info(usecase)

   • Get information about a specific usecase

   • Returns usecase details and function description

Example Usage in Claude

Can you analyze this data using the data_analysis usecase: [1, 2, 3, 4, 5]

Please convert "hello world" to uppercase using text_processing

Calculate the sum of 10, 20, and 30 using the calculation usecase

Deployment

For production deployment:

1. Docker Deployment (Recommended):

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY mcp_server.py .
CMD ["python3", "mcp_server.py"]

2. System Service:

# Run as a service
python3 mcp_server.py

3. Cloud Platforms:

   • Deploy to AWS Lambda, Google Cloud Functions, or Azure Functions

   • Modify transport from stdio to HTTP for web-based deployments

Development

Adding New Usecases

1. Add to usecase_functions dictionary in mcp_server.py

2. Create the corresponding function

3. Test with the test client

Custom Functions

Implement new functions following this pattern:

def your_custom_function(parameters: Dict[str, Any]) -> Dict[str, Any]:
    """Your function description"""
    # Process parameters
    # Return result dictionary
    pass

Troubleshooting

1. Import Errors: Ensure all dependencies are installed

2. Path Issues: Use absolute paths in Claude Desktop config

3. Permission Issues: Make sure the script is executable

4. Connection Issues: Verify the server starts without errors

Files

• mcp_server.py - Main MCP server implementation

• test_client.py - Test client for validation

• requirements.txt - Python dependencies

• claude_desktop_config.json - Example Claude Desktop configuration# mcp-server-test