DuckDuckGo Weather Memory Home Assistant Scripts

Provides web search, weather data, persistent memory storage, Home Assistant control, and script execution as MCP-enabled tools.

typescript

GitHub Stars

typescript

Language

8 months ago

First Indexed

4 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mudler-mcps": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MAX_RESULTS",
        "ghcr.io/mudler/mcps/duckduckgo:master"
      ],
      "env": {
        "HA_HOST": "http://localhost:8123",
        "SCRIPTS": "[{\"name\":\"hello\",\"description\":\"Hello script\",\"content\":\"#!/bin/bash\\necho hello\"}]",
        "HA_TOKEN": "your-home-assistant-token",
        "MAX_RESULTS": "10",
        "MEMORY_FILE_PATH": "/data/memory.json"
      }
    }
  }
}

You connect AI models to external tools and data sources using MCP servers. These servers provide practical capabilities like web search, weather data, memory storage, Home Assistant control, and script execution, enabling your models to perform real-world tasks with reliability and separation of concerns.

How to use

You interact with each MCP server through a compatible MCP client. Start a server locally or remotely, then reference its tool by name when you issue a request to perform a task. Use the available tools to search the web, fetch weather information, store and retrieve memories across sessions, control Home Assistant entities, or run predefined scripts and programs. Each server validates inputs and outputs with JSON schema to ensure consistent data exchange.

How to install

Prerequisites include Docker installed on your machine. You may also run these servers via LocalAI configurations if you integrate them into your model workflows.

Install steps for each MCP server: follow the exact commands shown for running the server container locally. Use the provided environment variables and volume mappings as shown in the examples.

# DuckDuckGo Search Server (example)
docker run -e MAX_RESULTS=10 ghcr.io/mudler/mcps/duckduckgo:latest

# Weather Server (example)
docker run ghcr.io/mudler/mcps/weather:latest

# Memory Server (example)
docker run -e MEMORY_FILE_PATH=/custom/path/memory.json ghcr.io/mudler/mcps/memory:latest

# Home Assistant Server (example)
docker run -e HA_TOKEN="your-token-here" -e HA_HOST="http://IP:PORT" ghcr.io/mudler/mcps/homeassistant:latest

# Script Runner Server (example)
docker run -e SCRIPTS='[{"name":"hello","description":"Hello script","content":"#!/bin/bash\necho hello"}]' ghcr.io/mudler/mcps/scripts:latest
```} ,{

Additional installation and setup notes

If you want to integrate these servers with a model, you can add a LocalAI configuration that launches the servers as stdio transports. Each section below shows the exact command structure to use, including required environment variables.

Security and maintenance

Treat these MCP servers as external execution points. Do not expose sensitive tokens or keys in logs. Rotate secrets regularly and use scoped permissions for any API tokens. Keep your container images up to date and monitor for updates from the image maintainers.

Troubleshooting

If a server fails to respond, verify that the container is running, check the container logs, and confirm that required environment variables are set correctly. Ensure network access between your MCP client and the server and verify that input data adheres to the JSON schemas the server validates against.

Available tools

search

Search the web using DuckDuckGo and return results in JSON format

get_weather

Get current weather and multi-day forecast for a city, with proper encoding for city names with special characters

add_memory

Add a new memory entry to persistent storage with a unique ID and timestamp

list_memory

List all memory entries stored in the memory file

remove_memory

Remove a memory entry by its unique ID

search_memory

Search memory entries by content with case-insensitive matching

list_entities

List all entities in Home Assistant with their current states

get_services

Get all available Home Assistant services with detailed information

call_service

Call a Home Assistant service to control devices (e.g., turn_on, turn_off)

search_entities

Search Home Assistant entities by keyword across ID, domain, state, and friendly name

search_services

Search Home Assistant services by keyword

Built by

VeilStrat

AI signals for GTM teams