MCP Weather Service

This repository is a simple service that uses the Model Context Protocol (MCP) to provide weather information for multiple cities (Fukuoka, Tokyo, Osaka, Moscow, New York, etc.).

Prerequisites
Project Setup
How to use
Development Guide
Upload to GitHub
troubleshooting

Prerequisites

To complete this project, you need the following software:

Node.js (version 18 and above)
npm (usually installed with Node.js)
Git

How to install

Installing Node.js and npm

Download the installer from the official Node.js website and install it.
Once the installation is complete, verify it by running the following command in Terminal:

node -v
npm -v

Installing Git

Download the installer from the official Git website and install it.
Once the installation is complete, verify it by running the following command in Terminal:

git --version

Project Setup

Creating a New Project

Create a new directory and navigate to it:

mkdir my-weather-mcp
cd my-weather-mcp

Initialize your npm project:

npm init -y

Install the required packages:

npm install @modelcontextprotocol/sdk axios zod typescript @types/node https-proxy-agent
npm install --save-dev ts-node

Create a TypeScript configuration file:

npx tsc --init

Edit your tsconfig.json file as follows:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "esModuleInterop": true,
    "outDir": "./build",
    "strict": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

Edit the scripts section of your package.json file as follows:

"scripts": {
  "build": "tsc && node -e \"import('fs').then(fs => fs.default.chmodSync('build/index.js', '755'))\"",
  "start": "node build/index.js",
  "inspect": "npx @modelcontextprotocol/inspector build/index.js",
  "dev": "ts-node src/index.ts"
}

Create the project directory structure:

mkdir -p src test

Clone an existing project

If you want to use an existing project, clone it:

git clone https://github.com/terisuke/my-weather-mcp.git
cd my-weather-mcp
npm install

How to use

Build and run

To build and run the project, use the following commands:

npm run build && npm run start

Using the Inspector

To test the weather service using the MCP Inspector, run the following command:

npm run build && npm run inspect

Once the Inspector is running, you can interact with the weather service by visiting http://127.0.0.1:6274 in your browser.

Get weather information

Using the Inspector, you can get weather information for the following cities:

Fukuoka
Tokyo
Osaka
Moscow
new york

Other cities can be specified, but they must be recognized by the Open-Meteo API.

Development Guide

File Structure

my-weather-mcp/
├── build/              # コンパイルされたJavaScriptファイル
├── src/                # TypeScriptソースコード
│   └── index.ts        # メインのアプリケーションコード
├── test/               # テストファイル
├── package.json        # プロジェクト設定
├── tsconfig.json       # TypeScript設定
└── README.md           # このファイル

Fixing the code

Edit the src/index.ts file to add or modify the functionality.
To test your changes, run the following command:

npm run build && npm run inspect

Once you are satisfied that the changes work, commit the changes.

Upload to GitHub

Creating your first GitHub repository

Go to GitHub and create an account or log in.
Click the "+" button in the top right and select "New repository".
Enter a repository name (for example, my-weather-mcp ) and add an optional description.
Set your repository to public or private and click "Create repository".

Initialize and push the local repository

In your local project directory, initialize a Git repository:

git init

Add your changes to the staging area:

git add .

Commit the changes:

git commit -m "初回コミット：MCP天気サービスの実装"

Add a remote repository (using the repository URL from GitHub):

git remote add origin https://github.com/ユーザー名/my-weather-mcp.git

Push the changes to the remote repository:

git push -u origin main

Pushing changes to an existing repository

Add your changes to the staging area:

git add .

Commit the changes:

git commit -m "変更内容の説明"

Push the changes to the remote repository:

git push

Creating a pull request

Go to the repository page on GitHub.
Click the "Pull requests" tab and then click the "New pull request" button.
Select the base branch and the compare branch.
Click the “Create pull request” button.
Enter a title and description for your pull request and click the "Create pull request" button.

troubleshooting

Common problems and solutions

`ERR_PACKAGE_PATH_NOT_EXPORTED` Error

This error occurs when the import path of the @modelcontextprotocol/sdk package is incorrect. Please fix it as follows:

// 誤ったインポート
import { McpServer } from "@modelcontextprotocol/sdk";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/transports";

// 正しいインポート
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

Network connection error

If you get a network error while making an API call, please check your proxy settings. You can use a proxy by setting the environment variables HTTP_PROXY or HTTPS_PROXY :

export HTTP_PROXY=http://プロキシサーバー:ポート
export HTTPS_PROXY=https://プロキシサーバー:ポート

Other issues

If the problem persists, please create an issue with the following information:

The error message that occurred
The version of Node.js and npm you are using
Command executed
Expected vs. Actual Behavior

MCP Weather Service

Integrations