Nefino

🚀 Nefino MCP サーバー

Nefino MCP サーバーは、モデルコンテキストプロトコル (MCP) に基づくサーバーで、大規模言語モデル (LLMs) にドイツの再生可能エネルギープロジェクト、計画、および公告に関するニュースと情報へのアクセスを提供します。Nefino API と統合され、構造化されたデータアクセスを提供します。

✨ 主な機能

• 地理位置に基づいてニュース記事を検索する
• 様々な再生可能エネルギーのトピック（太陽光、風力、水素など）で絞り込む
• 日付範囲と時効性のクエリをサポートする
• 環境変数による安全な認証を実現する
• 入力検証とエラー処理を行う
• 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

特定の場所に関するニュース記事を、様々なフィルタオプションで検索します。

パラメータ：

• place_id（文字列）：場所の ID
• place_type（列挙型）：場所のタイプ（PR、CTY、AU、LUA）
• 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 を使用した例：

2024 年 1 月から 6 月までのドイツの行政区画 DE9_AU0213 の再生可能エネルギーニュースを取得し、太陽光プロジェクトに焦点を当てる。

開発

開発モードで MCP Inspector を使用するには、以下のコマンドを実行します。

mcp dev -m mcp_nefino

エラー処理

サーバーは以下の内容を検証します。

• 日付形式（YYYY-MM-DD）
• 日付範囲の有効性
• RANGE モードと RECENCY モードのパラメータの組み合わせ
• API の認証情報と接続性
• ニューストピックの有効性

すべてのエラーには、問題の診断を支援するための説明メッセージが付属しています。

📄 ライセンス

詳細については、関連するライセンスファイルを参照してください。