Сервер MCP MarineTraffic

Сервер протокола контекста модели (MCP), который обеспечивает доступ к данным отслеживания судов MarineTraffic.

Функции

Этот сервер MCP предоставляет следующие возможности:

Инструменты

get_vessel_position : Получить текущее местоположение судна по номеру MMSI или IMO
get_vessel_details : Получить подробную информацию о судне по номеру MMSI или IMO
search_vessels : Поиск судов по названию, MMSI, IMO или типу судна
get_vessels_in_area : Получить суда в указанной географической области

Ресурсы

vessel://{identifier} : Информация о судне по номеру MMSI или IMO
ships://area/{lat}/{lon}/{radius} : Список судов в указанной географической области

Установка

Установка через Smithery

Чтобы автоматически установить сервер отслеживания судов MarineTraffic для Claude Desktop через Smithery :

npx -y @smithery/cli install @Cyreslab-AI/marinetraffic-mcp-server --client claude

Предпосылки

Node.js 18 или выше
Ключ API MarineTraffic (доступен в MarineTraffic API Services )

Настраивать

Клонируйте этот репозиторий или загрузите исходный код
Установите зависимости:

cd marinetraffic-server
npm install

Сборка сервера:

npm run build

Конфигурация

Для работы сервера требуется API-ключ MarineTraffic. Вы можете предоставить его через переменную окружения MARINETRAFFIC_API_KEY .

Конфигурация настроек MCP

Чтобы использовать этот сервер с Клодом, добавьте его в файл конфигурации настроек MCP:

Для приложения Claude Desktop (macOS)

Редактировать ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "marinetraffic": {
      "command": "node",
      "args": ["/path/to/marinetraffic-server/build/index.js"],
      "env": {
        "MARINETRAFFIC_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Для расширения VSCode Клода

Редактировать ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json :

{
  "mcpServers": {
    "marinetraffic": {
      "command": "node",
      "args": ["/path/to/marinetraffic-server/build/index.js"],
      "env": {
        "MARINETRAFFIC_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Примеры использования

После настройки и запуска сервера вы можете использовать его с Клодом для доступа к данным отслеживания судов:

Получить позицию судна

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_vessel_position</tool_name>
<arguments>
{
  "identifier": "123456789"
}
</arguments>
</use_mcp_tool>

Поиск судов

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>search_vessels</tool_name>
<arguments>
{
  "vessel_name": "MAERSK"
}
</arguments>
</use_mcp_tool>

Получить суда в области

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_vessels_in_area</tool_name>
<arguments>
{
  "latitude": 37.8199,
  "longitude": -122.4783,
  "radius": 10
}
</arguments>
</use_mcp_tool>

Доступ к ресурсам судна

<access_mcp_resource>
<server_name>marinetraffic</server_name>
<uri>vessel://123456789</uri>
</access_mcp_resource>

Ограничения API-ключа

API MarineTraffic имеет ограничения по использованию, основанные на вашем плане подписки. Помните об этих ограничениях при использовании сервера, чтобы не превысить квоту.

Поиск неисправностей

Ошибки ключа API : убедитесь, что ваш ключ API MarineTraffic действителен и правильно установлен в переменных среды.
Ограничение скорости : если вы столкнетесь с ошибками ограничения скорости, сервер автоматически повторит попытку с экспоненциальной задержкой, но вам может потребоваться подождать, прежде чем делать дополнительные запросы. Пример подробной информации о судне, доступной через API

Ограничения API-ключа

Поиск неисправностей

Ошибки ключа API : убедитесь, что ваш ключ API MarineTraffic действителен и правильно установлен в переменных среды.
Ограничение скорости : если вы столкнетесь с ошибками ограничения скорости, сервер автоматически повторит попытку с экспоненциальной задержкой, но вам может потребоваться подождать, прежде чем делать дополнительные запросы.
Данные не найдены : некоторые суда могут не иметь данных отслеживания в реальном времени, особенно небольшие суда или суда, находящиеся в районах с ограниченным покрытием AIS.

Лицензия

Данный проект лицензирован по лицензии ISC.

MarineTraffic MCP Server