Nefino

🚀 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 憑證和連接性
• 新聞主題的有效性

所有錯誤都會帶有描述性消息，以幫助診斷問題。

📄 許可證

請參考相關許可證文件以獲取詳細信息。