Prospector能源MCP服务器
MCP(模型上下文协议)服务器,允许AI代理访问浏览实验室能源数据API-47000多个互连队列项目、540万个分布式发电装置、6593个开发商档案、税收抵免计算和ITC交易来源。
现在通过MPP进行代理支付 --AI代理可以用USDC稳定币支付每次工具调用。
可用工具(35个工具)
项目与搜索
| 工具 | 描述 | 层级 |
|---|
search_projects | 按州、ISO、类型、开发商、容量搜索47K以上公用事业规模的能源项目 | 标准(0.01美元) |
get_project | 包含所有富集字段的完整项目详细信息 | 高级版(0.05美元) |
get_project_score | 项目的可投资性得分明细 | 溢价(0.05美元) |
get_queue_stats | 聚合互连队列统计信息 | 免费 |
get_milestone_summary | 里程碑和施工阶段统计 | 免费 |
export_projects | 将项目导出为CSV(最高50000) | 专业版(0.10美元) |
交易与投资
| 工具 | 描述 | 层级 |
|---|
find_itc_deals | ITC符合条件的投资机会,评分 | 溢价(0.05美元) |
get_itc_deal | 详细的ITC交易概况 | 保费(0.05美元) |
get_itc_summary | ITC交易汇总统计 | 免费 |
get_investable_projects | 预先筛选的分级可投资项目 | 溢价(0.05美元) |
get_investable_summary | 综合投资统计数据 | 免费 |
get_deal_sheet | 格式化的1页交易表(HTML,打印成PDF) | 专业版(0.10美元) |
税收抵免
| 工具 | 描述 | 层级 |
|---|
calculate_tax_credits | ITC/PTC资格,包括所有IRA奖金附加者 | 保费(0.05美元) |
check_domestic_content | 国内内容ITC奖金资格(+10%) | 保费(0.05美元) |
开发人员
| 工具 | 描述 | 层级 |
|---|
search_developers | 按名称搜索6593个开发者资料 | 标准版(0.01美元) |
get_developer | 完整的开发人员档案和业绩记录 | 高级版(0.05美元) |
get_developer_projects | 特定开发人员的所有项目 | 标准(0.01美元) |
get_developer_stats | 开发人员汇总统计信息 | 免费 |
市场数据
| 工具 | 描述 | 层级 |
|---|
get_lmp_daily | 每日位置边际价格 | 标准(0.01美元) |
get_lmp_monthly | 月平均LMP趋势 | 标准(0.01美元) |
get_lmp_zones | 列出可用的LMP定价区 | 免费 |
get_capacity_prices | 容量市场拍卖价格 | 标准(0.01美元) |
get_fuel_prices | 按州和类型划分的燃料价格 | 标准(0.01美元) |
get_technology_costs | NREL ATB成本预测 | 标准(0.01美元) |
get_rto_generation | 按燃料类型划分的RTO水平生成 | 标准(0.01美元) |
网格基础设施
| 工具 | 描述 | 层级 |
|---|
get_grid_turbines | 75K+美国风力涡轮机(USWTDB) | 标准(0.01美元) |
get_grid_transmission | 95K+传输线(HIFLD) | 标准(0.01美元) |
get_grid_substations | 64K+变电站(HIFLD) | 标准(0.01美元) |
get_generators | EIA发电机库存(26K+发电机) | 标准(0.01美元) |
分布式发电
| 工具 | 描述 | 层级 |
|---|
search_dg_projects | 搜索540万个分布式发电设施 | 标准配置(0.01美元) |
get_dg_stats | DG汇总统计 | 免费 |
get_investable_dg_projects | 预先筛选的可投资DG项目(得分超过5.5万) | 溢价(0.05美元) |
get_dg_investable_summary | 可投资DG统计汇总 | 免费 |
效用
| 工具 | 描述 | 层级 |
|---|
get_pricing | 查看所有工具的定价 | 免费 |
v0.4.0的新增功能
- 通过MPP进行代理付款 --通过机器支付协议以USDC稳定币为单位的每次工具调用定价
- 分级定价 --免费统计/摘要,$0.01搜索,$0.05高级查找,$0.10交易单
get_pricing 工具 --客服可以在致电之前发现工具成本- 向后兼容的 --没有
MPP_RECIPIENT_ADDRESS一切如常
设置
克劳德桌面版
{
"mcpServers": {
"prospector-energy": {
"command": "uvx",
"args": ["prospector-energy-mcp"]
}
}
}
克劳德代码
添加到您的 .mcp.json:
{
"mcpServers": {
"prospector-energy": {
"command": "uvx",
"args": ["prospector-energy-mcp"]
}
}
}
光标
添加到光标设置>MCP服务器:
{
"prospector-energy": {
"command": "uvx",
"args": ["prospector-energy-mcp"]
}
}
直接安装
# From PyPI
pip install prospector-energy-mcp
# With payment support
pip install prospector-energy-mcp[payments]
# Or with uv
uvx prospector-energy-mcp
配置
| 环境变量 | 描述 | 默认值 |
|---|
PROSPECTOR_API_URL | API基本URL | https://prospector-platform-production.up.railway.app |
PROSPECTOR_API_KEY | 用于身份验证访问的API密钥 | 无(自由层) |
MPP_RECIPIENT_ADDRESS | 用于接收付款的钱包地址(启用MPP) | 无(禁用付款) |
MPP_SECRET_KEY | 用于支付质询验证的HMAC密钥 | 自动生成 |
MPP_REALM | 支付挑战的服务器领域 | prospectorlabs.io |
代理付款(MPP)
此服务器支持 机器支付协议(MPP) 用于USDC稳定币的每次工具调用付款。启用后,拥有资金钱包的AI代理可以自主支付数据查询费用。
运作原理
- 代理调用付费工具(例如。,
search_projects) - 服务器以支付质询(相当于HTTP 402)进行响应
- 代理人在Tempo区块链上以美元支付
- 服务器验证付款并返回数据
- 免费工具(统计数据、摘要)始终免费使用
定价
| 层级 | 成本/通话 | 工具 |
|---|
| 自由 | $0.00 | 统计数据、摘要、区域列表、定价信息 |
| 标准 | $0.01 | 搜索、生成器、市场数据、网格数据 |
| 高级 | 0.05美元 | 项目详情、税收抵免、开发商简介、可投资项目 |
| 专业版 | $0.10 | 交易单,批量CSV导出 |
代理现金
此服务器也可在 代理现金 --拥有USDC钱包的代理商可以自动发现和支付能源数据。
示例查询
连接后,询问您的AI代理:
- “ERCOT队列中有多少太阳能项目?”
- “计算西弗吉尼亚州2MW太阳能项目的税收抵免”
- “在新泽西州寻找信贷利率高于50%的可投资ITC交易”
- “告诉我开发商NextEra Energy的业绩记录”
- “本周PJM的平均LMP是多少?”
- “在加利福尼亚州寻找超过100MW的电池存储项目”
- “每个工具的成本是多少?”(电话
get_pricing)
发展
# Clone and install in dev mode
cd mcp-server
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e ".[payments]"
# Run with stdio transport (default)
python -m prospector_energy
# Run with SSE transport
python -m prospector_energy --sse
# Test with MCP inspector
npx @modelcontextprotocol/inspector python -m prospector_energy