Solematica MCP Server

@solematica/mcp-server

面向 Solematica 的 MCP（Model Context Protocol）服务——为意大利提供太阳能估算、服务商比较和能源数据。

此服务可让 Claude、Cursor、Windsurf、Kiro 等 AI 助手以及其他 MCP 兼容客户端分析太阳能潜力、比较光伏服务商、查询能源价格，并搜索意大利市场的能源相关文章。

工具

工具	描述	身份验证
stima_solare	为意大利地址生成完整的太阳能估算——发电量、节省金额、投资回报率、面板规格	API 密钥
info_tetto	通过 Google Solar API 分析卫星图像中的屋顶——面积、朝向、分区、面板潜力	免费
confronta_provider	比较 11 家意大利太阳能服务商——价格、组件、保修、透明度指数	免费
dettaglio_provider	服务商完整详情——配件（热泵、电动汽车充电器、锅炉）、联系方式、融资	免费
prezzi_energia	当前意大利能源价格（PUN/ARERA）及更新日期	免费
cerca_articoli	按类别或关键词搜索 Solematica 博客文章	免费

快速开始

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "solematica": {
      "command": "npx",
      "args": ["@solematica/mcp-server"],
      "env": {
        "SOLEMATICA_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add solematica npx @solematica/mcp-server

Cursor

添加到你的 .cursor/mcp.json：

{
  "mcpServers": {
    "solematica": {
      "command": "npx",
      "args": ["@solematica/mcp-server"],
      "env": {
        "SOLEMATICA_API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

添加到你的 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "solematica": {
      "command": "npx",
      "args": ["@solematica/mcp-server"],
      "env": {
        "SOLEMATICA_API_KEY": "your-api-key"
      }
    }
  }
}

其他 MCP 客户端

任何 MCP 兼容客户端都可以通过 stdio 传输使用此服务：

npx @solematica/mcp-server

身份验证

• stima_solare 仅需API 密钥（每次估算会消耗额度）
• 其他所有工具均免费且公开——无需 API 密钥
• 在 solematica.it/partner 注册成为合作伙伴，即可获取 API 密钥

环境变量

变量	必需	默认值	描述
SOLEMATICA_API_KEY	仅用于 stima_solare	—	用于经过身份验证的端点的 API 密钥
SOLEMATICA_API_URL	否	https://api.solematica.it/api/v1	API 基础 URL（用于可自托管部署或测试）

工具详情

stima_solare

使用 Google Solar API + PVGIS 数据，为意大利地址生成完整的太阳能估算。

输入：

• indirizzo（必填）——完整的意大利地址（例如：“Via Roma 1, 20100 Milano MI”）
• consumo_annuo_kwh——年用电量，单位为 kWh（默认值：3500）
• tipo_abitazione——建筑类型：indipendente、bifamiliare、schiera、condominio
• superficie_tetto_mq——屋顶面积，单位为平方米（若省略，则根据卫星图像自动计算）
• orientamento——屋顶朝向：nord、sud、est、ovest

返回： kWp 规格、面板数量、年发电量、月度分布、节省金额、投资回报率、避免的 CO2 排放量、成本估算。

info_tetto

使用 Google Solar API 的卫星数据分析屋顶。

输入：

• lat（必填）— 纬度
• lng（必填）— 经度

返回： 屋顶表面积、可用面积、朝向、屋顶分区、最大面板数量、日照时长。

confronta_provider

列出所有活跃的意大利太阳能服务商及其对比数据。请参阅 Solematica 上的完整服务商对比。

返回： 服务商数组，包含名称、价格（3 kWp）、面板品牌、逆变器品牌、保修、透明度指数（1-3）以及配套服务的可用情况（热泵、电动汽车充电桩、锅炉）。

dettaglio_provider

指定服务商的完整详情。

输入：

• slug（必填）— 服务商 slug：enel、iren、plenitude、otovo、eon、hera、a2a、edison、engie、sorgenia、bluenergy

返回： 所有对比数据，以及描述、电话、总部、成立年份、融资详情、包含 URL 的配套服务详情。

prezzi_energia

来自 Solematica 数据库的意大利当前能源价格，每月根据 ARERA 和 GME 的数据更新。

返回： 自发自用电价（EUR/kWh）、SSP 电价、每 kWp 成本范围、每 kWh 电池成本、上次更新时间。

cerca_articoli

在 Solematica 博客中搜索能源相关文章。

输入：

• categoria — 按类别筛选（例如 fotovoltaico、incentivi、risparmio）
• limit — 最多返回的结果数（默认值：10，最大值：50）

返回： 文章列表，包含标题、slug、类别、日期、描述和完整 URL。

示例

向 Claude 提问：

• “位于 Via Garibaldi 15, Torino 的光伏系统能发电多少？”
• “比较 Enel 和 Iren 的光伏报价。”
• “哪些服务商还提供热泵？”
• “意大利当前的能源价格是多少？”
• “搜索 2026 年光伏激励政策相关文章。”

链接

• Solematica — 主平台
• 服务商对比 — 对比 11 家意大利太阳能服务商
• 太阳能估算 — 免费太阳能估算工具
• 能源指南 — 完整能源指南
• API 文档 — REST API 文档
• 博客 — 能源文章和新闻
• npm 包 — npm 注册表页面
• Model Context Protocol — MCP 规范
• MCP 服务 — 更多 MCP 服务

相关内容

• Google Solar API — 基于卫星数据的太阳能潜力分析
• PVGIS — 欧盟光伏估算工具
• ARERA — 意大利能源监管机构
• Superbonus 与激励政策 — 意大利太阳能激励政策信息

许可证

MIT — 请参阅 LICENSE 文件。

作者

Solematica — Soloweb SRL