Метеорологическая служба MCP
Этот репозиторий представляет собой простую службу, которая предоставляет информацию о погоде с использованием протокола контекста модели (MCP). Вы можете получить информацию о погоде для нескольких городов (Фукуока, Токио, Осака, Москва, Нью-Йорк и т. д.).
оглавление
Предпосылки
Для выполнения этого проекта вам понадобится следующее программное обеспечение:
Node.js (версия 18 и выше)
npm (обычно устанавливается вместе с Node.js)
Гит
Как установить
Установка Node.js и npm
Загрузите установщик с официального сайта Node.js и установите его.
После завершения установки проверьте ее, выполнив следующую команду в Терминале:
Установка Git
Загрузите установщик с официального сайта Git и установите его.
После завершения установки проверьте ее, выполнив следующую команду в Терминале:
Настройка проекта
Создание нового проекта
Создайте новый каталог и перейдите в него:
Инициализируйте свой проект npm:
Установите необходимые пакеты:
Создайте файл конфигурации TypeScript:
Отредактируйте файл
tsconfig.jsonследующим образом:
Отредактируйте раздел скриптов вашего файла
package.jsonследующим образом:
Создайте структуру каталогов проекта:
Клонировать существующий проект
Если вы хотите использовать существующий проект, клонируйте его:
Как использовать
Построить и запустить
Для сборки и запуска проекта используйте следующие команды:
Использование инспектора
Чтобы протестировать службу погоды с помощью MCP Inspector, выполните следующую команду:
После запуска Inspector вы можете взаимодействовать со службой погоды, перейдя по адресу http://127.0.0.1:6274 в своем браузере.
Получить информацию о погоде
С помощью Инспектора вы можете получить информацию о погоде в следующих городах:
Фукуока
Токио
Осака
Москва
Нью-Йорк
Можно указать и другие города, но они должны распознаваться API Open-Meteo.
Руководство по разработке
Структура файла
Исправление кода
Отредактируйте файл
src/index.tsчтобы добавить или изменить функциональность.Чтобы проверить изменения, выполните следующую команду:
Как только вы убедитесь, что изменения работают, зафиксируйте их.
Загрузить на GitHub
Создание вашего первого репозитория GitHub
Перейдите на GitHub и создайте учетную запись или войдите в систему.
Нажмите кнопку «+» в правом верхнем углу и выберите «Новый репозиторий».
Введите имя репозитория (например,
my-weather-mcp) и добавьте необязательное описание.Сделайте свой репозиторий публичным или частным и нажмите «Создать репозиторий».
Инициализируйте и отправьте локальный репозиторий
В локальном каталоге проекта инициализируйте репозиторий Git:
Добавьте изменения в область подготовки:
Внесите изменения:
Добавьте удаленный репозиторий (используя URL-адрес репозитория из GitHub):
Отправьте изменения в удаленный репозиторий:
Передача изменений в существующий репозиторий
Добавьте изменения в область подготовки:
Внесите изменения:
Отправьте изменения в удаленный репозиторий:
Создание запроса на извлечение
Перейдите на страницу репозитория на GitHub.
Нажмите вкладку «Запросы на извлечение», а затем нажмите кнопку «Новый запрос на извлечение».
Выберите базовую ветвь и ветвь сравнения.
Нажмите кнопку «Создать запрос на извлечение».
Введите название и описание вашего запроса на извлечение и нажмите кнопку «Создать запрос на извлечение».
Поиск неисправностей
Распространенные проблемы и решения
Ошибка ERR_PACKAGE_PATH_NOT_EXPORTED
Эта ошибка возникает, если путь импорта для пакета @modelcontextprotocol/sdk неверен. Пожалуйста, исправьте это следующим образом:
Ошибка сетевого подключения
Если при выполнении вызова API возникает сетевая ошибка, проверьте настройки прокси-сервера. Вы можете использовать прокси, установив переменные среды HTTP_PROXY или HTTPS_PROXY :
Другие вопросы
Если проблема не устранена, пожалуйста, создайте сообщение о проблеме, указав следующую информацию:
Сообщение об ошибке, которое произошло
Версию Node.js и npm, которую вы используете
Команда выполнена.
Ожидаемое и фактическое поведение