New England Power Grid MCP Server

ISO新英格兰电网信息模型上下文协议

该项目实现了一个用于新英格兰电网信息的模型上下文协议（MCP）服务器。 数据来源于 ISO新英格兰，负责监督 新英格兰电网。此MCP服务器建立在ISO新英格兰的ISO Express web服务API之上，记录在\[https://webservices.iso-ne.com/docs/v1.1/\]

什么是MCP服务器以及我们为什么需要它

MCP服务器是一个标准化的接口，为人工智能模型，特别是大型语言模型（LLM）提供“工具”。一个典型的例子是向法学硕士提出一个问题，比如“旧金山现在的天气怎么样？”。法学硕士不能自己回答这个问题。它需要一个“工具”来获取现在的天气来回答这个问题

使用此MCP服务器需要什么

你需要创建一个 免费ISO Express帐户 使用ISO新英格兰获取用户名和密码

此MCP服务器可以回答哪些问题

示例问题：新英格兰目前的边际燃料是什么？ 示例答案：边际燃料是天然气和木材 内部实现：访问/genfuelmix/current api端点 注：边际燃料是指如果你现在想在电网上使用电力，电网将如何提供额外的电力

isone的基本api是什么

iso新web服务api的基本api是\[https://webservices.iso-ne.com/api/v1.1\]

安装和设置

1.安装依赖项

pip install -r requirements.txt

2.配置凭据

1. 复制示例环境文件：

   cp .env.example .env

1. 编辑 .env 并添加您的ISO Express凭据：

   ISO_NE_USERNAME=your_actual_username
   ISO_NE_PASSWORD=your_actual_password

3.测试服务器

您可以直接测试MCP工具：

python test_mcp_tools.py

运行MCP服务器

选项1：直接执行

python run_mcp_server.py

选项2：使用主模块

python main.py

服务器将通过stdin/stdout上的JSON-RPC进行通信，并可以连接到Claude Desktop等MCP客户端。

MCP客户端配置

Claude桌面配置

将此添加到您的Claude Desktop MCP配置文件中：

{
  "mcpServers": {
    "iso-newengland": {
      "command": "python",
      "args": ["/path/to/your/iso_newengland_mcp_server/run_mcp_server.py"],
      "env": {
        "ISO_NE_USERNAME": "your_iso_ne_username",
        "ISO_NE_PASSWORD": "your_iso_ne_password"
      }
    }
  }
}

替换 /path/to/your/ 带有项目目录的实际路径。

可用工具

get_marginal_fuel()

返回新英格兰电网的当前边际燃料类型。边际燃料是指如果现在电网需要额外电力，将使用的发电类型。

示例用法： “现在新英格兰的边际燃料是什么？”

Marginal Fuel Example

get_full_fuel_mix()

返回新英格兰电网的完整当前发电燃料组合，包括以兆瓦为单位的发电量和哪些燃料是边际的。

示例用法： “现在给我看看新英格兰电网的完整燃料组合。”

Fuel Mix Example

项目结构

iso_newengland_mcp_server/
├── main.py                 # Main entry point
├── run_mcp_server.py       # Convenience script with better error handling
├── test_mcp_tools.py       # Test script for MCP tools
├── test_api_direct.py      # Direct API testing script
├── requirements.txt        # Python dependencies
├── .env.example           # Example environment variables
├── mcp-config.json        # Example MCP client configuration
└── src/
    ├── __init__.py
    ├── server.py          # FastMCP server implementation
    ├── api/
    │   ├── __init__.py
    │   └── iso_ne_client.py   # ISO New England API client
    ├── config/
    │   ├── __init__.py
    │   └── settings.py        # Configuration management
    └── models/
        ├── __init__.py
        └── fuel_mix.py        # Pydantic data models

API详细信息

此MCP服务器使用ISO新英格兰Web服务API v1.1。基本URL为：

https://webservices.iso-ne.com/api/v1.1

使用的端点

• /genfuelmix/current -当前一代燃料组合数据

获取json结果的完整端点示例：\[https://webservices.iso-ne.com/api/v1.1//genfuelmix/current.json\]

认证

API要求使用您的ISO Express凭据通过SSL进行HTTP基本身份验证。

故障排除

常见问题

1. 缺少凭据错误

- 确保您已创建 .env 使用您的ISO Express凭据进行文件 - 验证您的用户名和密码是否正确

1. API身份验证错误

- 验证您的ISO Express帐户是否处于活动状态 - 检查您的凭据是否在中正确设置 .env 文件

1. 导入错误

- 确保安装了所有依赖项： pip install -r requirements.txt - 验证您是从项目根目录运行的