Weather Mpc S

🚀 Weather MCP Server (weather-mcp-s)

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

🚀 Quick Start

# Install dependencies
npm install

# Build the project
npm run build

✨ Features

This project is a Model Context Protocol (MCP) server built using the mcp - framework. It allows users to add custom tools, develop tools according to a specific structure, publish the project to npm, and integrate it with Claude Desktop.

📦 Installation

# Install dependencies
npm install

# Build the project
npm run build

💻 Usage Examples

Project Structure

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

Adding Components

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

# Add a new tool
mcp add tool my-tool

# For example, you can create the following tools:
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 = "Describe the functionality of your tool";

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

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

export default MyTool;

Publishing to npm

1. Update package.json:

   • Ensure the name is unique and complies with npm naming conventions.
   • Set an appropriate version.
   • Add information such as description, author, license, etc.
   • Check that 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. Log in to npm (create an account if necessary):

   npm login
   

4. Publish your package:

   npm publish
   

After publishing, users can add it to their Claude Desktop client (as described below) or run it using npx.

Using with Claude Desktop

Local Development

Add the following to your Claude Desktop configuration file:

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

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

Configuration after Publishing

Add the following to your Claude Desktop configuration file:

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

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

Building and Testing

1. Modify your tool.
2. Run npm run build to build.
3. The server will automatically load your tool when starting.

📚 Documentation

• MCP Framework Github
• MCP Framework Documentation