openweather-mcp-server

sesch29/openweather-mcp-server

3.1

If you are the rightful owner of openweather-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server facilitates communication between AI applications and external data sources, such as weather services, by using a standardized protocol.

Readme

End-user Usage (nerd-level)

If you just want to use it in your MCP-ready AI application of your choice, follow these steps:

  • Get your personal openweathermap.org API key:

    • Create an Account
    • Create an API-key here
      • Open the configuration file of your AI application. Depending on your app, this might be different. You need to add this data to your configuration (e.g. from librechat.yaml): 
        mcpServers:
  openweather-mcp-server:
    type: stdio
    command: java
    args:
      - -jar 
      - /app/my-mcp-servers/openweather-mcp-server-0.1.2.jar
      - --spring.config.additional-location=file:/app/my-mcp-servers/application-prod.yml

  • Download the *.jar file of the openweather-mcp-server

  • Copy it into a location that is reachable

    • LibreChat in Docker: create a folder /LIBRECHAT/my-mcp-servers/

  • Make sure, java is installed in the location

    • LibreChat in Docker: in /LIBRECHAT/Dockerfile change this line:

      # original
RUN apk add --no-cache python3 py3-pip uv
# change into this
RUN apk add --no-cache python3 py3-pip uv openjdk21-jre

  • Make sure, everything is reachable and packed together:

    • LibreChat in Docker:

      • In file /LIBRECHAT/docker-compose.yml:

        # original
image: ghcr.io/danny-avila/librechat-dev:latest
# change into this
# image: ghcr.io/danny-avila/librechat-dev:latest
build: .

      • Now you can rebuild

  • Now you can rebuild, restart. With the current versions it is sufficient to execute docker compose build --no-cache && docker compose up -d. On any problems, please stick to the update guide.

  • In your AI application, you should now be able to activate the "openweather-mcp-server" and ask for the current weather in any city :-)

Development: Environment variables

To execute the remote calls to openweathermap.org, you need a personal API key (see above) and set it in an application profile (application-dev.yml) or environment-variable.

Set this environment variable (e.g. in your test-starters): secret.openweathermap.apikey=YOUR-OPENWEATHERMAP-API-KEY