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的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燃油数据仅供非商业用途）。

任何通过stdio支持MCP的客户端——Claude Desktop、Cursor、Continue，以及使用MCP SDK的自定义客户端。

许可证

MIT © Marcelo Domingues