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 (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\)에 추가:

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

Cursor

~/.cursor/mcp.json (또는 프로젝트의 .cursor/mcp.json)에 추가:

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

모든 MCP 호스트

서버는 stdio를 통해 MCP와 통신합니다. 서버 명령으로 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는 동일한 데이터를 위한 독립형 다국어 SDK 패밀리 — precos-combustiveis-pt, ipma-api, geoapi-pt-sdk, ine-pt 및 dados-gov-pt — 의 AI 인터페이스 계층입니다. 서버는 자체적으로 완전하며 (API를 직접 호출) 따라서 해당 패키지에 대한 의존성이 없습니다.

개발

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

FAQ

아니요. 모든 도구는 무료 공개 포르투갈 API를 사용합니다.

아니요 — 독립적인 커뮤니티 프로젝트입니다. 각 제공자의 이용 약관을 준수해 주십시오 (DGEG 연료 데이터는 비상업적 용도입니다).

stdio를 통해 MCP와 통신하는 모든 호스트 — Claude Desktop, Cursor, Continue 및 MCP SDK를 사용하는 사용자 정의 클라이언트.

라이선스

MIT © Marcelo Domingues