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
- Prerrequisitos
- Configuración del proyecto
- Cómo utilizar
- Guía de desarrollo
- Subir a GitHub
- solución de problemas
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
- Descargue el instalador del sitio web oficial de Node.js e instálelo.
- Una vez completada la instalación, verifíquela ejecutando el siguiente comando en la Terminal:
Instalación de Git
- Descargue el instalador del sitio web oficial de Git e instálelo.
- Una vez completada la instalación, verifíquela ejecutando el siguiente comando en la Terminal:
Configuración del proyecto
Creando un nuevo proyecto
- Crea un nuevo directorio y navega hasta él:
mkdir my-weather-mcp
cd my-weather-mcp
- Inicialice su proyecto npm:
- Instalar los paquetes necesarios:
npm install @modelcontextprotocol/sdk axios zod typescript @types/node https-proxy-agent
npm install --save-dev ts-node
- Cree un archivo de configuración de TypeScript:
- 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"]
}
- 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"
}
- Crear la estructura del directorio del proyecto:
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.
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
- Edite el archivo
src/index.ts para agregar o modificar la funcionalidad. - Para probar sus cambios, ejecute el siguiente comando:
npm run build && npm run inspect
- Una vez que esté satisfecho de que los cambios funcionan, confirme los cambios.
Subir a GitHub
Creando tu primer repositorio de GitHub
- Vaya a GitHub y cree una cuenta o inicie sesión.
- Haga clic en el botón "+" en la parte superior derecha y seleccione "Nuevo repositorio".
- Ingrese un nombre de repositorio (por ejemplo,
my-weather-mcp ) y agregue una descripción opcional. - Configure su repositorio como público o privado y haga clic en "Crear repositorio".
Inicializar y enviar el repositorio local
- En el directorio de su proyecto local, inicialice un repositorio Git:
- Añade tus cambios al área de preparación:
- Confirmar los cambios:
git commit -m "初回コミット：MCP天気サービスの実装"
- Agregue un repositorio remoto (usando la URL del repositorio de GitHub):
git remote add origin https://github.com/ユーザー名/my-weather-mcp.git
- Envíe los cambios al repositorio remoto:
Enviar cambios a un repositorio existente
- Añade tus cambios al área de preparación:
- Confirmar los cambios:
- Envíe los cambios al repositorio remoto:
- Vaya a la página del repositorio en GitHub.
- Haga clic en la pestaña "Solicitudes de extracción" y luego haga clic en el botón "Nueva solicitud de extracción".
- Seleccione la rama base y la rama de comparación.
- Haga clic en el botón “Crear solicitud de extracción”.
- 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