Weather Mpc S

🚀 天気 MCP サーバー (weather-mcp-s)

mcp-framework を使用して構築されたモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

# 依存関係のインストール
npm install

# プロジェクトのビルド
npm run build

📁 プロジェクト構造

weather-mcp-s/
├── src/
│   ├── tools/        # MCP ツールディレクトリ
│   │   └── ExampleTool.ts
│   └── index.ts      # サーバーエントリーファイル
├── package.json
└── tsconfig.json

➕ コンポーネントの追加

プロジェクトには src/tools/ExampleTool.ts にサンプルツールが付属しています。CLI を使用してさらに多くのツールを追加できます：

# 新しいツールの追加
mcp add tool my-tool

# 例えば、以下のようなツールを作成できます：
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler

💻 ツール開発

サンプルツールの構造：

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

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "ツールの機能を説明します";

  schema = {
    message: {
      type: z.string(),
      description: "この入力パラメータの説明",
    },
  };

  async execute(input: MyToolInput) {
    // ここにツールのロジックを記述します
    return `処理後のメッセージ：${input.message}`;
  }
}

export default MyTool;

📦 npm への公開

1. package.json の更新：

   • name が一意で npm の命名規則に従っていることを確認します
   • 適切な version を設定します
   • description、author、license などの情報を追加します
   • bin が正しいエントリーファイルを指していることを確認します

2. ローカルでのビルドとテスト：

   npm run build
   npm link
   weather-mcp-s  # ローカルで CLI をテストします
   

3. npm へのログイン（必要に応じてアカウントを作成）：

   npm login
   

4. パッケージの公開：

   npm publish
   

公開後、ユーザーは Claude デスクトップクライアントに追加することができます（以下に説明）。または、npx を使用して実行することもできます。

🖥️ Claude Desktop での使用

ローカル開発時

Claude Desktop の設定ファイルに以下の内容を追加します：

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"]
    }
  }
}

公開後の設定

Claude Desktop の設定ファイルに以下の内容を追加します：

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"
      }
    }
  }
}

🔨 ビルドとテスト

1. ツールを変更します
2. npm run build を実行してビルドします
3. サーバー起動時に自動的にツールが読み込まれます

ℹ️ 詳細情報

• MCP Framework Github
• MCP Framework ドキュメント