weather-mcp-s

by bee1194

271 downloads
Not rated
GitHub

About

weather-mcp-s is an MCP (Model Context Protocol) server built with the mcp-framework. It is designed to be used with Claude Desktop and other MCP-compatible clients, enabling weather-related tool calls via the OpenWeatherMap API.

Details

Author
bee1194
Downloads
271
Categories
Media

- Built with mcp-framework for easy tool development.
- Provides an example tool structure for custom tools.
- Supports publishing to npm for broader distribution.
- Integrates with Claude Desktop via MCP configuration.
- Uses OpenWeatherMap API (environment variable required).

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name weather-mcp-s
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install dependencies with npm install, build with npm run build, then configure in Claude Desktop by adding the server to claude_desktop_config.json with either a local path or npx command. The server requires an OPENWEATHERMAP_API_KEY environment variable.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "weather-mcp-s": {
            "weather-mcp-s": {
                "command": "/absolute/path/to/node",
                "args": [
                    "/absolute/path/to/weather-mcp-s/dist/index.js"
                ]
            }
        }
    }
}

McpServers

{
    "weather-mcp-s": {
        "command": "/absolute/path/to/node",
        "args": [
            "/absolute/path/to/weather-mcp-s/dist/index.js"
        ]
    }
}

weather-mcp-s

A Model Context Protocol (MCP) server built with mcp-framework.

Quick Start

# Install dependencies
npm install

Build the project

npm run build

Project Structure

weather-mcp-s/
├── src/
│   ├── tools/        # MCP Tools
│   │   └── ExampleTool.ts
│   └── index.ts      # Server entry point
├── package.json
└── tsconfig.json

Adding Components

The project comes with an example tool in src/tools/ExampleTool.ts. You can add more tools using the CLI:

# Add a new tool
mcp add tool my-tool

Example tools you might create:

mcp add tool data-processor mcp add tool api-client mcp add tool file-handler

Tool Development

Example tool structure:

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
message: string;
}

class MyTool extends MCPTool<MyToolInput> {
name = "my_tool";
description = "Describes what your tool does";

schema = {
message: {
type: z.string(),
description: "Description of this input parameter",
},
};

async execute(input: MyToolInput) {
// Your tool logic here
return Processed: ${input.message};
}
}

export default MyTool;

Publishing to npm

1. Update your package.json:

- Ensure name is unique and follows npm naming conventions
- Set appropriate version
- Add description, author, license, etc.
- Check bin points to the correct entry file

2. Build and test locally:

   npm run build
   npm link
   weather-mcp-s  # Test your CLI locally
   

3. Login to npm (create account if necessary):

   npm login
   

4. Publish your package:

   npm publish

After publishing, users can add it to their claude desktop client (read below) or run it with npx


Using with Claude Desktop

Local Development

Add this configuration to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%/Claude/claude_desktop_config.json

json
{
"mcpServers": {
"weather-mcp-s": {
"command": "/absolute/path/to/node",
"args":["/absolute/path/to/weather-mcp-s/dist/index.js"]
}
}
}

After Publishing

Add this configuration to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

json
{
"mcpServers": {
"weather-mcp-s": {
"command": "npx",
"args": ["weather-mcp-s"]
"env": {
"OPENWEATHERMAP_API_KEY": "your_api_key"
}
}
}
}
``

Building and Testing

1. Make changes to your tools
2. Run
npm run build` to compile
3. The server will automatically load your tools on startup

Learn More

- MCP Framework Github
- MCP Framework Docs

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.