使用说明

项目简介

Nefino MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型（LLM）提供关于德国可再生能源项目、规划和公告的最新新闻和信息。它充当LLM客户端和Nefino API之间的桥梁，将复杂的API数据转化为结构化的、易于LLM理解和利用的上下文信息。通过此服务器，LLM可以访问最新的可再生能源动态，从而在相关对话和应用中提供更准确、更具 context 感知的回应。

主要功能点

新闻检索: 根据地理位置检索德国可再生能源新闻。
主题过滤: 支持按多种可再生能源主题（太阳能、风能、氢能等）过滤新闻。
时间范围查询: 支持指定日期范围或最近天数的查询方式。
安全认证: 通过环境变量进行安全认证，保护API访问。
输入验证与错误处理: 对用户输入进行验证，并提供详细的错误信息。
MCP协议兼容: 完全兼容Model Context Protocol，确保与各种MCP客户端的互操作性。

安装步骤

前提条件:
- 确保已安装 Python 3.10 或更高版本。
- 拥有 Nefino API 的访问权限和凭据。

安装: 打开终端或命令提示符，运行以下命令安装 Nefino MCP 服务器：

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

服务器配置

MCP 服务器需要通过环境变量进行配置。以下是在 Claude Desktop 客户端中配置 Nefino MCP 服务器的 'claude_desktop_config.json' 示例，您需要根据您的实际 Nefino API 凭据进行修改：

{
  "mcpServers": {
    "nefino": {  // 服务器名称，可以自定义
      "command": "python",  // 启动服务器的命令，这里使用 python
      "args": ["-m", "mcp_nefino"],  // 启动服务器的参数，运行 mcp_nefino 模块
      "env": {  // 环境变量配置
        "NEFINO_USERNAME": "your_username",  // 您的 Nefino API 用户名
        "NEFINO_PASSWORD": "your_password",  // 您的 Nefino API 密码
        "NEFINO_JWT_SECRET": "your_jwt_secret",  // 您的 Nefino API JWT 密钥
        "NEFINO_BASE_URL": "http://api_endpoint"  // Nefino API 的基础 URL
      }
    }
  }
}

请注意: 将上述 JSON 配置添加到您的 Claude Desktop 配置文件中 ('~/Library/Application Support/Claude/claude_desktop_config.json' on macOS 或 '%APPDATA%\Claude\claude_desktop_config.json' on Windows)，并替换 'your_username', 'your_password', 'your_jwt_secret', 和 'http://api_endpoint' 为您的实际值。配置完成后，重启 Claude Desktop 以加载配置。

基本使用方法

配置完成后，您可以使用支持 MCP 协议的客户端（如 Claude Desktop）与 Nefino MCP 服务器进行交互。

示例查询 (通过 Claude):

您可以使用自然语言指令，指示 Claude 从 Nefino MCP 服务器获取数据。例如，您可以向 Claude 提出如下问题：

Get renewable energy news for administrative unit DE9_AU0213 from January to June 2024, focusing on solar projects.

Nefino MCP 服务器将解析您的请求，调用相应的工具 (例如 'retrieve_news_items_for_place')，并从 Nefino API 获取数据，最终将结果返回给 Claude。您可以通过类似的方式，结合不同的参数，查询您关心的可再生能源新闻。

直接运行服务器:

您也可以直接在终端中运行 Nefino MCP 服务器，用于开发或调试：

python -m mcp_nefino

要进行开发并使用 MCP Inspector，可以运行：

mcp dev -m mcp_nefino

关键词