MCP Server

@Cavumnigrum

Repository

Basic information

About MCP Server

Test MCP server that can do several things

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

MCP Server config

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

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

MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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.

Frequently asked questions

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.

Comments

More Developer Tools MCP servers

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.