README.md•8.56 kB
# MCP 天気サービス
このリポジトリは、Model Context Protocol (MCP) を使用して天気情報を提供するシンプルなサービスです。複数の都市（福岡、東京、大阪、モスクワ、ニューヨークなど）の天気情報を取得できます。
<a href="https://glama.ai/mcp/servers/@terisuke/my-weather-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@terisuke/my-weather-mcp/badge" alt="Weather Service MCP server" />
</a>
## ライセンス
このプロジェクトは [MITライセンス](LICENSE) の下で公開されています。
## 目次
1. [前提条件](#前提条件)
2. [プロジェクトのセットアップ](#プロジェクトのセットアップ)
3. [使い方](#使い方)
4. [開発ガイド](#開発ガイド)
5. [GitHubへのアップロード](#githubへのアップロード)
6. [トラブルシューティング](#トラブルシューティング)
## 前提条件
このプロジェクトを実行するには、以下のソフトウェアが必要です：
- Node.js (バージョン 18 以上)
- npm (通常は Node.js とともにインストールされます)
- Git
### インストール方法
#### Node.js と npm のインストール
1. [Node.js 公式サイト](https://nodejs.org/) からインストーラーをダウンロードしてインストールします。
2. インストールが完了したら、ターミナルで以下のコマンドを実行して確認します：
```bash
node -v
npm -v
```
#### Git のインストール
1. [Git 公式サイト](https://git-scm.com/) からインストーラーをダウンロードしてインストールします。
2. インストールが完了したら、ターミナルで以下のコマンドを実行して確認します：
```bash
git --version
```
## プロジェクトのセットアップ
### 新規プロジェクトの作成
1. 新しいディレクトリを作成し、そのディレクトリに移動します：
```bash
mkdir my-weather-mcp
cd my-weather-mcp
```
2. npm プロジェクトを初期化します：
```bash
npm init -y
```
3. 必要なパッケージをインストールします：
```bash
npm install @modelcontextprotocol/sdk axios zod typescript @types/node https-proxy-agent
npm install --save-dev ts-node
```
4. TypeScript の設定ファイルを作成します：
```bash
npx tsc --init
```
5. `tsconfig.json` ファイルを以下のように編集します：
```json
{
"compilerOptions": {
"target": "ES2022",
"module": "NodeNext",
"moduleResolution": "NodeNext",
"esModuleInterop": true,
"outDir": "./build",
"strict": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true
},
"include": ["src/**/*"],
"exclude": ["node_modules"]
}
```
6. `package.json` ファイルのスクリプトセクションを以下のように編集します：
```json
"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"
}
```
7. プロジェクトのディレクトリ構造を作成します：
```bash
mkdir -p src test
```
### 既存プロジェクトのクローン
既存のプロジェクトを使用する場合は、以下の手順でクローンします：
```bash
git clone https://github.com/terisuke/my-weather-mcp.git
cd my-weather-mcp
npm install
```
## 使い方
### ビルドと実行
プロジェクトをビルドして実行するには、以下のコマンドを使用します：
```bash
npm run build && npm run start
```
### インスペクターの使用
MCP インスペクターを使用して天気サービスをテストするには、以下のコマンドを実行します：
```bash
npm run build && npm run inspect
```
インスペクターが起動すると、ブラウザで `http://127.0.0.1:6274` にアクセスして、天気サービスとやり取りできます。
### 天気情報の取得
インスペクターを使用して、以下の都市の天気情報を取得できます：
- 福岡
- 東京
- 大阪
- モスクワ
- ニューヨーク
その他の都市も指定できますが、Open-Meteo API で認識される都市名である必要があります。
## 開発ガイド
### ファイル構造
```
my-weather-mcp/
├── build/ # コンパイルされたJavaScriptファイル
├── src/ # TypeScriptソースコード
│ └── index.ts # メインのアプリケーションコード
├── test/ # テストファイル
├── package.json # プロジェクト設定
├── tsconfig.json # TypeScript設定
└── README.md # このファイル
```
### コードの修正
1. `src/index.ts` ファイルを編集して、機能を追加または修正します。
2. 変更をテストするには、以下のコマンドを実行します：
```bash
npm run build && npm run inspect
```
3. 変更が正常に動作することを確認したら、変更をコミットします。
## GitHubへのアップロード
### 初めてのGitHubリポジトリ作成
1. [GitHub](https://github.com/) にアクセスし、アカウントを作成またはログインします。
2. 右上の「+」ボタンをクリックし、「New repository」を選択します。
3. リポジトリ名（例：`my-weather-mcp`）を入力し、必要に応じて説明を追加します。
4. リポジトリを公開または非公開に設定し、「Create repository」をクリックします。
### ローカルリポジトリの初期化とプッシュ
1. ローカルプロジェクトディレクトリで、Gitリポジトリを初期化します：
```bash
git init
```
2. 変更をステージングエリアに追加します：
```bash
git add .
```
3. 変更をコミットします：
```bash
git commit -m "初回コミット：MCP天気サービスの実装"
```
4. リモートリポジトリを追加します（GitHubのリポジトリURLを使用）：
```bash
git remote add origin https://github.com/ユーザー名/my-weather-mcp.git
```
5. 変更をリモートリポジトリにプッシュします：
```bash
git push -u origin main
```
### 既存リポジトリへの変更のプッシュ
1. 変更をステージングエリアに追加します：
```bash
git add .
```
2. 変更をコミットします：
```bash
git commit -m "変更内容の説明"
```
3. 変更をリモートリポジトリにプッシュします：
```bash
git push
```
### プルリクエストの作成
1. GitHubのリポジトリページにアクセスします。
2. 「Pull requests」タブをクリックし、「New pull request」ボタンをクリックします。
3. ベースブランチとコンペアブランチを選択します。
4. 「Create pull request」ボタンをクリックします。
5. プルリクエストのタイトルと説明を入力し、「Create pull request」ボタンをクリックします。
## トラブルシューティング
### よくある問題と解決策
#### `ERR_PACKAGE_PATH_NOT_EXPORTED` エラー
このエラーは、`@modelcontextprotocol/sdk` パッケージのインポートパスが正しくない場合に発生します。以下のように修正してください：
```typescript
// 誤ったインポート
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";
```
#### ネットワーク接続エラー
API呼び出し中にネットワークエラーが発生した場合、プロキシ設定を確認してください。環境変数 `HTTP_PROXY` または `HTTPS_PROXY` を設定することで、プロキシを使用できます：
```bash
export HTTP_PROXY=http://プロキシサーバー:ポート
export HTTPS_PROXY=https://プロキシサーバー:ポート
```
#### その他の問題
問題が解決しない場合は、以下の情報を含むイシューを作成してください：
- 発生したエラーメッセージ
- 使用しているNode.jsとnpmのバージョン
- 実行したコマンド
- 期待される動作と実際の動作