similicious/kleinanzeigen-mcp-server

Kleinanzeigen MCP Server

A Model Context Protocol (MCP) server that provides tools to interact with Kleinanzeigen. This server enables AI assistants to search for listings and retrieve detailed information about specific listings from Kleinanzeigen.

Prerequisites

• Node.js (v16 or higher recommended)
• A running instance of the DanielWTE/ebay-kleinanzeigen-api

Installation

1. Clone this repository:

   git clone https://github.com/similicious/kleinanzeigen-mcp-server.git
   cd kleinanzeigen-mcp-server
   

2. Install dependencies:

   npm install
   

Available Tools

1. search

Search for listings on Kleinanzeigen.

Parameters:

• query (required): Search term
• zipCode (optional): ZIP code for location-based search
• radius (optional): Search radius in kilometers
• minPrice (optional): Minimum price filter
• maxPrice (optional): Maximum price filter

Example:

// Search for "iphone" in ZIP code 12345 with a 10km radius and price between 200 and 500
{
  "query": "iphone",
  "zipCode": "12345",
  "radius": 10,
  "minPrice": 200,
  "maxPrice": 500
}

2. get_listing

Retrieve detailed information about a specific listing.

Parameters:

• id (required): The ID of the listing

Example:

// Get details for listing with ID "2363153061"
{
  "id": "2363153061"
}

Response Format

Both tools return responses in JSON format with detailed information about the listings.

Integration with AI Assistants

This MCP server is designed to be used with AI assistants that support the Model Context Protocol. When connected, the assistant can use the provided tools to search for listings and retrieve detailed information.

Example configuration in an AI assistant:

{
  "mcp_servers": {
    "kleinanzeigen": {
      "command": "node",
      "args": ["/path/to/kleinanzeigen-mcp-server/src/index.mjs"],
      "env": {
        "API_BASE_URL": "http://your-api-host:port"
      }
    }
  }
}

This example shows how to configure the MCP server in your AI assistant's configuration file. Replace /path/to/kleinanzeigen-mcp-server/src/index.mjs with the actual path to the server script and http://your-api-host:port with the URL where your Kleinanzeigen API is running.