Skip to main content
Glama
Sign In
enesjakozh
MCP Server Demo

MCP Server Demo

by dynstat
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

MCP Server Demo

A simple demonstration project for the Model Control Protocol (MCP) server implementation. MCP client implementation will be provided in the future.

Overview

This project demonstrates a simple MCP server built with FastMCP that provides several tools and resources for AI assistants to use:

  • News Article Fetching: Query and retrieve news articles from WorldNewsAPI

  • Simple Calculation: Basic addition functionality

  • Weather Information: Simple weather data retrieval

  • Dynamic Greeting: Personalized greeting resource

Related MCP server: MCP Server Demo

Setup

Prerequisites

  • Python 3.x

  • Required Python packages (used for testing):

    • mcp-server

    • worldnewsapi

Installation

  1. Clone this repository

  2. Install dependencies:

    uv add mcp-server
    uv add worldnewsapi
    pip install mcp-server worldnewsapi

Usage

Running the Server

Run the server with Python: from MCP related configuration and restart the client, like claude desktop or cursor ide mcp.

Available Tools

3 tools
addC

Add two numbers

Inputs: a (required), b (required).

fetch_news_articlesB
Fetches news articles from the WorldNewsAPI based on specified parameters
and returns them as a list of dictionaries.

Args:
    query_text (str): The text to search for in news articles
    earliest_date (str): Earliest publication date in YYYY-MM-DD format
    latest_date (str): Latest publication date in YYYY-MM-DD format
    max_results (int): Maximum number of results to return

Returns:
    list: A list of dictionaries containing article details

Inputs: query_text, earliest_date, latest_date, max_results.

get_weatherC

it gets and retuns the weather of the city

Inputs: city (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    C2.6/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: 'add' performs arithmetic, 'fetch_news_articles' retrieves news data, and 'get_weather' provides weather information. The descriptions reinforce these unique domains, making misselection unlikely.

    Naming Consistency2/5

    The naming is inconsistent with mixed conventions: 'add' uses a simple verb, 'fetch_news_articles' follows a verb_noun pattern with snake_case, and 'get_weather' uses a verb_noun pattern but with different verb style ('get' vs 'fetch'). This lack of pattern reduces predictability.

    Tool Count2/5

    With only 3 tools, the server feels thin and under-scoped for a general-purpose 'MCP Server Demo', as it covers unrelated domains (math, news, weather) without depth in any area. This minimal set suggests a lack of coherent focus.

    Completeness1/5

    The tool set is severely incomplete for any discernible domain; it appears to be a random collection of unrelated utilities. There are obvious gaps, such as no update or delete operations for news or weather, and no coverage of basic workflows beyond simple fetches and addition.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MCP Demo Server

      joeguo911
      F
      license
      C
      quality
      D
      maintenance
      A demonstration server based on Model Context Protocol (MCP) that showcases how to build custom tools for AI assistants, providing mathematical calculation and multilingual greeting capabilities.
      3
      -

    • MCP Server Demo

      bollam1818
      A
      license
      Not graded
      quality
      Not graded
      maintenance
      A demonstration MCP server that provides calculator tools for arithmetic operations, personalized greeting resources, and code review prompt templates. Enables users to perform basic math calculations, generate dynamic greetings, and access reusable code review templates through the Model Context Protocol.
      MIT

    • MCP Server Demo

      hxw-haha
      A
      license
      Not graded
      quality
      D
      maintenance
      A minimal Model Context Protocol server demo that exposes tools through HTTP API, including greeting, weather lookup, and HTTP request capabilities. Demonstrates MCP server implementation with stdio communication and HTTP gateway functionality.
      6 npm
      ISC

    • FastMCP Basic Server

      sharmaratnesh
      F
      license
      Not graded
      quality
      C
      maintenance
      A basic MCP server implementation using the FastMCP framework that provides utility tools for greetings and mathematical calculations. It is designed to demonstrate tool integration for AI-assisted development workflows like Cline.
      -