MCP Weather Server Demo

This project is a sample MCP (Model Context Protocol) server that exposes a tool to fetch the weather for any city using the Open-Meteo API.

Features

• Basic MCP server using `@modelcontextprotocol/sdk` and `zod` for validation.
• `fetch-weather` tool that takes a city name and returns current weather information.
• Uses public APIs for geocoding and weather data.

Installation

1. Clone this repository:

git clone https://github.com/your-username/your-repo.git
   cd your-repo

2. Install dependencies:

npm install

Usage

Run the MCP server:

npx tsx main.ts

This will start the server and you can connect from any compatible MCP client.

Note:

You can also run this to use the inspector on the web browser.

npx -y @modelcontextprotocol/inspector npx -y tsx main.ts

1.- Run the command.

2.- Go to the link provided in console.

3.- Configure the enviroment this way:

4.- Connect -> List Tools -> Select your MCP -> Start using it.

Main structure

• `main.ts`: Source code for the server and weather tool.
• `package.json`: Project dependencies and scripts.

BONUS

I attatched a json file (with a different name), which is used on Claude an AI Assistant built by Anthropic.

In this file, we can use the AI to do incredible things, such as the following and many more:

1.- Get access to folders and interact with your computer. 📁

https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem

`

"mcpServers": {

"filesystem": {

"command": "npx",

"args": [

"-y",

"@modelcontextprotocol/server-filesystem",

"/Users/username/Desktop",

"/path/to/other/allowed/dir"

]

}

}

`

Tasks examples (via prompts):

Give permission to access the Desktop

etc.

2.- Get access to a database and start prompting simple or complex tasks. 🤖

https://github.com/modelcontextprotocol/servers-archived/tree/main/src/postgres

`

"postgres": {

"command": "npx",

"args": [

"-y",

"@modelcontextprotocol/server-postgres",

"postgresql://DB_USER:DB_PASS@localhost:5432/DB_NAME"

]

}

`

Tasks examples (via prompts):

• Truncate a single table
• Get all data from a single user and export it into a csv file.
• Get all activity from a user that has root privileges on diferent tables.

etc.

You can install Claude Agent and configure the json file like this to test them.

*[Just make sure you are using the Claude configuration in both cases.]*

NOTE

the 'weather' element in the configuration file, is the MCP we just created. Yes, you can using on Claude too.

License

This project is licensed under the MIT License. See the `LICENSE` file for details.

> Example project to learn how to create MCP tools and consume public APIs.