Nefino MCP 服务器

Nefino MCP 服务器是一个 模型上下文协议 (MCP) 服务器，它为大型语言模型 (LLM) 提供对德国可再生能源项目、规划和公告的新闻和信息的访问。它与 Nefino API 集成，以提供对此数据的结构化访问。

功能

• 检索特定地理位置的新闻项目
• 按各种可再生能源主题（太阳能、风能、氢能等）进行过滤
• 支持基于日期范围和基于最近性的查询
• 通过环境变量进行安全身份验证
• 输入验证和错误处理
• 完全兼容 MCP

安装

前提条件

• Python 3.10 或更高版本
• 访问 Nefino API（需要凭据）

安装

pip install git+https://github.com/nefino/mcp-nefino.git

配置

服务器需要设置几个环境变量。 它们应该在运行服务器时直接传入。

NEFINO_USERNAME=你的用户名
NEFINO_PASSWORD=你的密码
NEFINO_JWT_SECRET=你的 JWT 密钥
NEFINO_BASE_URL=http://api_endpoint

用法

使用 Claude Desktop

1. 安装 Claude Desktop

2. 将以下内容添加到您的 Claude Desktop 配置中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "nefino": {
      "command": "python",
      "args": ["-m", "mcp_nefino"],
      "env": {
        "NEFINO_USERNAME": "你的用户名",
        "NEFINO_PASSWORD": "你的密码",
        "NEFINO_JWT_SECRET": "你的 JWT 密钥",
        "NEFINO_BASE_URL": "http://api_endpoint"
      }
    }
  }
}

3. 重启 Claude Desktop

直接使用

您也可以直接运行服务器：

python -m mcp_nefino

可用工具

retrieve_news_items_for_place

检索特定地点的新闻项目，并提供各种过滤选项。

参数：

• place_id (字符串): 地点的 ID
• place_type (枚举): 地点类型 (PR, CTY, AU, LAU)
• range_or_recency (枚举, 可选): RANGE 或 RECENCY
• last_n_days (整数, 可选): 回溯的天数（对于 RECENCY 模式）
• date_range_begin (字符串, 可选): 开始日期，格式为 YYYY-MM-DD（对于 RANGE 模式）
• date_range_end (字符串, 可选): 结束日期，格式为 YYYY-MM-DD（对于 RANGE 模式）
• news_topics (枚举列表, 可选): 要过滤的主题 (BATTERY_STORAGE, GRID_EXPANSION, SOLAR, HYDROGEN, WIND)

通过 Claude 的示例查询：

获取行政单位 DE9_AU0213 从 2024 年 1 月到 6 月的可再生能源新闻，重点关注太阳能项目。

开发

要在 MCP Inspector 中以开发模式运行：

mcp dev -m mcp_nefino

错误处理

服务器对以下内容执行验证：

• 日期格式 (YYYY-MM-DD)
• 日期范围有效性
• RANGE 与 RECENCY 模式的参数组合
• API 凭据和连接性
• 新闻主题有效性

所有错误都会返回描述性消息，以帮助诊断问题。

许可证

[许可证类型 - 例如，MIT] - 有关详细信息，请参阅 LICENSE 文件