Weather MCP

🚀 🌤️ Said MCP - リアルタイム気象サービス

Said MCP は、MCP（Model Context Protocol）サーバーのシンプルで強力な実装です。アクセスしやすく拡張性のあるツールを通じて、リアルタイムの気象情報を提供することを目的としています。

✨ 主な機能

• 🔧 @modelcontextprotocol/sdk を使用した カスタムMCPサーバー
• 📍 Open-Meteo APIによる 高精度な地理位置情報
• 🌡️ 現在の気象データ：温度、降雨、降水量
• ⚡ stdio を介した輸送に基づく シンプルで効率的なインターフェース

🧠 動作原理

サーバーは obtener-clima というツールを公開しており、任意の都市の天気状況を照会することができます。地理座標で位置を解決し、最新の気象データを照会します。

🔍 実行フロー

1. 🏙️ 都市名を受け取ります。
2. 🌍 Open-Meteoの地理コーディングAPIを通じて緯度と経度を取得します。
3. ☁️ 現在の気象データを照会します。
4. 📝 構造化された形式で情報を返します。

📦 プロジェクト構造

.
├── .gitignore
├── main.ts              # MCPサーバーのメインファイル
├── package.json         # プロジェクトの依存関係とメタデータ
├── package-lock.json    # 依存関係のバージョン管理
└── README.md            # このファイル 📝

🛠️ 必要条件

• NodeJS >= 18
• TypeScript
• インターネットアクセス（API呼び出し用）

💻 使用例

基本的な使用法

server.tool(
  'obtener-clima',
  'Herramienta para obtener el clima en tiempo real',
  { city: z.string().describe('City name') },
  async ({ city }) => {
    // Consulta a la API y retorno de datos...
  }
)

高度な使用法

// 高度なシナリオでは、以下のように拡張することができます。
server.tool(
  'obtener-clima',
  'Herramienta para obtener el clima en tiempo real',
  { city: z.string().describe('City name'), additionalParam: z.string().describe('Additional parameter') },
  async ({ city, additionalParam }) => {
    // Consulta a la API y retorno de datos...
  }
)

🔌 統合

サーバーは StdioServerTransport を使用して接続し、MCP互換システムとの簡単な統合を可能にします。

const transport = new StdioServerTransport()
await server.connect(transport)

📄 ライセンス

MIT License

✨ 作者

Said Ruiz によって情熱を持って開発されました。