Servicio Meteorológico del MCP

Este repositorio es un servicio simple que proporciona información meteorológica utilizando el Protocolo de Contexto de Modelo (MCP). Puede obtener información meteorológica de varias ciudades (Fukuoka, Tokio, Osaka, Moscú, Nueva York, etc.).

Tabla de contenido

1. Prerrequisitos

2. Configuración del proyecto

3. Cómo utilizar

4. Guía de desarrollo

5. Subir a GitHub

6. solución de problemas

Related MCP server: Weather MCP

Prerrequisitos

Para completar este proyecto, necesitará el siguiente software:

• Node.js (versión 18 y superiores)

• npm (generalmente se instala con Node.js)

• Git

Cómo instalar

Instalación de Node.js y npm

1. Descargue el instalador del sitio web oficial de Node.js e instálelo.

2. Una vez completada la instalación, verifíquela ejecutando el siguiente comando en la Terminal:

node -v
npm -v

Instalación de Git

1. Descargue el instalador del sitio web oficial de Git e instálelo.

2. Una vez completada la instalación, verifíquela ejecutando el siguiente comando en la Terminal:

git --version

Configuración del proyecto

Creando un nuevo proyecto

1. Crea un nuevo directorio y navega hasta él:

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

2. Inicialice su proyecto npm:

npm init -y

3. Instalar los paquetes necesarios:

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

4. Cree un archivo de configuración de TypeScript:

npx tsc --init

5. Edite su archivo tsconfig.json de la siguiente manera:

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

6. Edite la sección de scripts de su archivo package.json de la siguiente manera:

"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. Crear la estructura del directorio del proyecto:

mkdir -p src test

Clonar un proyecto existente

Si desea utilizar un proyecto existente, clónelo:

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

Cómo utilizar

Construir y ejecutar

Para construir y ejecutar el proyecto, utilice los siguientes comandos:

npm run build && npm run start

Usando el Inspector

Para probar el servicio meteorológico utilizando el Inspector MCP, ejecute el siguiente comando:

npm run build && npm run inspect

Una vez que el Inspector esté ejecutándose, puede interactuar con el servicio meteorológico visitando http://127.0.0.1:6274 en su navegador.

Obtener información meteorológica

Utilizando el Inspector, puede obtener información meteorológica de las siguientes ciudades:

• Fukuoka

• Tokio

• Osaka

• Moscú

• Nueva York

Se pueden especificar otras ciudades, pero deben ser reconocidas por la API de Open-Meteo.

Guía de desarrollo

Estructura de archivos

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

Arreglando el código

1. Edite el archivo src/index.ts para agregar o modificar la funcionalidad.

2. Para probar sus cambios, ejecute el siguiente comando:

npm run build && npm run inspect

3. Una vez que esté satisfecho de que los cambios funcionan, confirme los cambios.

Subir a GitHub

Creando tu primer repositorio de GitHub

1. Vaya a GitHub y cree una cuenta o inicie sesión.

2. Haga clic en el botón "+" en la parte superior derecha y seleccione "Nuevo repositorio".

3. Ingrese un nombre de repositorio (por ejemplo, my-weather-mcp ) y agregue una descripción opcional.

4. Configure su repositorio como público o privado y haga clic en "Crear repositorio".

Inicializar y enviar el repositorio local

1. En el directorio de su proyecto local, inicialice un repositorio Git:

git init

2. Añade tus cambios al área de preparación:

git add .

3. Confirmar los cambios:

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

4. Agregue un repositorio remoto (usando la URL del repositorio de GitHub):

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

5. Envíe los cambios al repositorio remoto:

git push -u origin main

Enviar cambios a un repositorio existente

1. Añade tus cambios al área de preparación:

git add .

2. Confirmar los cambios:

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

3. Envíe los cambios al repositorio remoto:

git push

Crear una solicitud de extracción

1. Vaya a la página del repositorio en GitHub.

2. Haga clic en la pestaña "Solicitudes de extracción" y luego haga clic en el botón "Nueva solicitud de extracción".

3. Seleccione la rama base y la rama de comparación.

4. Haga clic en el botón “Crear solicitud de extracción”.

5. Ingrese un título y una descripción para su solicitud de extracción y haga clic en el botón "Crear solicitud de extracción".

solución de problemas

Problemas y soluciones comunes

Error ERR_PACKAGE_PATH_NOT_EXPORTED

Este error ocurre cuando la ruta de importación del paquete @modelcontextprotocol/sdk es incorrecta. Por favor, arréglelo de la siguiente manera:

// 誤ったインポート
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";

Error de conexión de red

Si recibe un error de red al realizar una llamada API, verifique la configuración de su proxy. Puede utilizar un proxy configurando las variables de entorno HTTP_PROXY o HTTPS_PROXY :

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

Otros problemas

Si el problema persiste, cree un problema con la siguiente información:

• El mensaje de error que se produjo

• La versión de Node.js y npm que estás usando

• Comando ejecutado

• Comportamiento esperado vs. comportamiento real