mcp-pt

[!ВАЖНО] Это неофициальный общественный проект. Он не связан с поставщиками данных (DGEG, IPMA, INE, GeoAPI.pt, AMA/dados.gov.pt). Соблюдайте условия каждого поставщика — в частности, данные о топливе DGEG предназначены для некоммерческого использования.

Что он делает

Задайте вашему AI-ассистенту такие вопросы, как:

• "Какая самая дешевая дизельная заправка в округе Лиссабон?"

• "Завтра в Порту будет дождь? Есть активные метеопредупреждения?"

• "Какой населенный пункт имеет почтовый индекс 1990-096?"

• "Сколько жителей было в Португалии по переписи 2021 года?"

• "Найди наборы данных об окружающей среде на dados.gov.pt."

…и он вызовет нужный инструмент, обратится к публичному API и ответит реальными данными.

Related MCP server: IPMA MCP Server

Установка

Запустите с помощью npx (установка не требуется) — просто укажите его вашему MCP-хосту.

Claude Desktop

Добавьте в claude_desktop_config.json (~/Library/Application Support/Claude/ на macOS, %APPDATA%\Claude\ на Windows):

{
  "mcpServers": {
    "pt": {
      "command": "npx",
      "args": ["-y", "mcp-pt"]
    }
  }
}

Cursor

Добавьте в ~/.cursor/mcp.json (или в .cursor/mcp.json проекта):

{
  "mcpServers": {
    "pt": { "command": "npx", "args": ["-y", "mcp-pt"] }
  }
}

Любой MCP-хост

Сервер использует MCP через stdio. Запустите npx -y mcp-pt (или node dist/index.js из клонированного репозитория) в качестве команды сервера.

Инструменты

Все инструменты обращаются к бесплатным, публичным API и не требуют ключей API.

Пример (сырой MCP)

# List the tools over stdio
printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"x","version":"0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | npx -y mcp-pt

Как это связано с SDK

mcp-pt — это AI-ориентированный слой над семейством автономных многоязычных SDK для тех же данных — precos-combustiveis-pt, ipma-api, geoapi-pt-sdk, ine-pt и dados-gov-pt. Сервер является самодостаточным (он вызывает API напрямую), поэтому не зависит от этих пакетов.

Разработка

npm install
npm test        # vitest
npm run build   # tsup → dist/index.js (executable)
node dist/index.js

Часто задаваемые вопросы

Нет. Каждый инструмент использует бесплатное публичное португальское API.

Нет — это независимый общественный проект. Пожалуйста, соблюдайте условия каждого поставщика (данные DGEG о топливе предназначены для некоммерческого использования).

Любые, поддерживающие MCP через stdio — Claude Desktop, Cursor, Continue и пользовательские клиенты, использующие MCP SDK.

Лицензия

MIT © Marcelo Domingues