Skip to main content
Glama
FacuPVe

MCP Weather Server

by FacuPVe

Introducción a los MCP

En este proyecto se han seguido los pasos del vídeo de Midudev: https://www.youtube.com/watch?v=wnHczxwukYY junto con otra documentación educativa para aprender sobre los MCP (Model Context Protocol) y crear mi primer MCP.

Descripción

Se han hecho pruebas con Claude para comprobar el funcionamiento de los MCP con los archivos de mi equipo y una base de datos postgress junto con la creación de un MCP personalizado.

Herramientas/tecnologías utilizadas:

Related MCP server: My MCP Server

Creación del proyecto

mkdir mcp-weather
cd mcp-weather
pnpm init # Creará el package.json

A partir de este punto quedaría crear el archivo main.ts y seguir los pasos del video.

Dependencias

pnpm add @modelcontextprotocol/sdk zod
pnpm add -D tsx

Estructura del proyecto

  • main.ts: Código fuente del servidor MCP.

  • package.json: Dependencias y scripts del proyecto.

  • .gitignore: Archivos y carpetas ignorados por git.

  • pnpm-lock.yaml: Archivo de bloqueo de dependencias (ignorado en git).

  • README.md: Documentación del proyecto.

Available Tools

1 tool
fetch-weatherC

Tool to fetch the weather of a city

ParametersJSON Schema
NameRequiredDescriptionDefault
cityYesNombre de la ciudad

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure but offers minimal information. It doesn't describe response format, error handling, rate limits, authentication needs, or other behavioral traits beyond the basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with a single, direct sentence that clearly states the tool's purpose. There is no wasted verbiage, and it is appropriately front-loaded with essential information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete for effective tool use. It doesn't explain what weather data is returned, format details, or other contextual information needed beyond the basic action, leaving significant gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, with the 'city' parameter documented as 'Nombre de la ciudad'. The description adds no additional parameter semantics beyond what's in the schema, so it meets the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with a specific verb ('fetch') and resource ('weather of a city'), making it immediately understandable. However, it doesn't differentiate from siblings since there are none, so it can't achieve the highest score for that criterion.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, prerequisites, or context-specific considerations. It merely states what the tool does without any usage instructions or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

TDQS

B3.1/5.0
Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'fetch-weather' has a clearly distinct and unambiguous purpose.

Naming Consistency5/5

A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'fetch-weather' follows a clear verb-noun pattern.

Tool Count2/5

A single tool is too few for a weather server's apparent scope, which typically involves multiple operations like forecasts, alerts, or historical data. This minimal set feels thin and incomplete for the domain.

Completeness2/5

The tool surface is severely incomplete for a weather domain. It only provides current weather for a city, missing essential operations like forecasts, alerts, multi-location queries, or historical data, which will cause agent failures in broader tasks.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    A customizable Model Context Protocol server built with mcp-framework that enables Claude to access external tools and capabilities through a standardized interface.
    88
  • F
    license
    Not graded
    quality
    C
    maintenance
    A beginner MCP server that enables Claude to read local text, CSV, and Markdown files. Built as a learning project to understand how to connect AI to local file systems using the MCP protocol.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FacuPVe/intro-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server