🚀 Nefino MCP 服务器

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

🚀 快速开始

Nefino MCP 服务器能助力大型语言模型获取德国可再生能源领域的新闻和信息。以下为你详细介绍其安装、配置及使用方法。

✨ 主要特性

• 地理位置检索：可根据地理位置检索新闻条目。
• 主题筛选：支持按太阳能、风能、氢能源等各种可再生能源主题进行筛选。
• 日期查询：支持日期范围和时效性查询。
• 安全认证：通过环境变量实现安全身份验证。
• 输入验证与错误处理：具备输入验证和错误处理功能。
• 协议兼容：完全兼容 MCP。

📦 安装指南

先决条件

• Python 3.10 或更高版本
• 访问 Nefino API 的权限（需要凭证）

安装命令

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

📚 详细文档

配置

服务器运行时需设置几个环境变量，可在运行时直接传递：

NEFINO_USERNAME=your_username
NEFINO_PASSWORD=your_password
NEFINO_JWT_SECRET=your_jwt_secret
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": "your_username",
        "NEFINO_PASSWORD": "your_password",
        "NEFINO_JWT_SECRET": "your_jwt_secret",
        "NEFINO_BASE_URL": "http://api_endpoint"
      }
    }
  }
}

3. 重启 Claude Desktop。

直接使用

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

python -m mcp_nefino

可用工具

retrieve_news_items_for_place

该工具可根据特定位置检索新闻条目，带有各种过滤选项。

示例查询通过 Claude：

获取 2024 年 1 月至 6 月德国行政区域 DE9_AU0213 的可再生能源新闻，聚焦于太阳能项目。

开发

使用 MCP Inspector 在开发模式下运行：

mcp dev -m mcp_nefino

错误处理

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

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

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

📄 许可证

请参考相关许可证文件以获取详细信息。