MCP Server

Name: MCP Server
Author: Cavumnigrum

@Cavumnigrum

Repository

About MCP Server

Test MCP server that can do several things

#mcp-server #python #weather #currency #news

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "test_MCPServer": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server?

MCP Server is a Python-based MCP (Model Context Protocol) server that provides the current USD exchange rate, weather forecast, and news from the last week. It is intended for developers who want to integrate these external data sources into MCP-compatible applications.

How to use MCP Server?

Clone the repository, create a Python virtual environment, install dependencies, and set up API keys for exchangerate-api, openweathermap, and newsapi in a .env file. Run the server with python mcp_server.py – it becomes available at http://localhost:8000. A self‑written client can be launched with python mcp_client.py. Docker deployment is also supported via docker-compose.

Key features of MCP Server

Provides current USD exchange rate from exchangerate-api.com.
Delivers weather forecast from openweathermap.org.
Supplies news articles from the last week via newsapi.org.
Written in Python and follows the MCP protocol.
Includes a test suite runnable with pytest.
Docker‑Compose files for containerized server and client.

Use cases of MCP Server

Fetch the live USD exchange rate for a finance dashboard.
Get a weather forecast for a location using an MCP client.
Retrieve recent news headlines for aggregation or analysis.
Serve as a learning example for building an MCP server in Python.
Deploy a lightweight data gateway using Docker containers.

FAQ from MCP Server

What data sources does MCP Server integrate?

It uses exchangerate-api.com for USD exchange rates, openweathermap.org for weather forecasts, and newsapi.org for recent news articles.

What API keys are required?

You need to register and obtain API keys from exchangerate-api.com, openweathermap.org, and newsapi.org. Place them in a .env file following the .env.example template.

How do I start the server?

After installing dependencies and configuring keys, run python mcp_server.py. The server will listen on http://localhost:8000.

Is there a client to interact with the server?

Yes, a self‑written client is provided. Run python mcp_client.py and follow the in‑program instructions to use it.

Can I run MCP Server with Docker?

Yes. The repository includes Docker and docker-compose files. Use docker-compose up -d server to start the server and docker-compose run --rm client to run the client interactively.