Senechal MCP サーバー

Senechal プロジェクトの補助として機能し、Senechal API から LLM アプリケーションにヘルスデータを提供するモデル コンテキスト プロトコル (MCP) サーバー。

概要

このサーバーは、LLMがSenechal APIから健康データにアクセスするための標準化されたインターフェースを提供します。以下の情報が公開されます。

• リソース: LLM のコンテキストにロードできる健康データ

• ツール: LLM が健康データを取得するために呼び出すことができる関数

• プロンプト: 健康データを分析するための再利用可能なテンプレート

インストール

1. このリポジトリをクローンする

2. 仮想環境を作成します。

   python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate

3. 依存関係をインストールします:

   pip install -r requirements.txt

構成

.env.exampleファイルを.envにコピーし、Senechal API キーと URL を追加します。

サーバーが機能するには、API キーと API URL の両方が必要です。

Windows 構成

Windows で実行する場合は、次の点に注意してください。

1. 設定ではバックスラッシュまたは適切にエスケープされたパスを使用します

2. claude-desktop-config.json で Python 仮想環境へのフル パスを使用します。

MCP 構成の環境変数は.envファイルを使用しないため、構成で明示的に設定する必要があることに注意してください。

使用法

クライアント/サーバー設定のテスト

セットアップをテストする最も簡単な方法は、サンプル クライアントを実行することです。

サーバーを起動する

MCP Inspectorを使用した開発モード

Claude Desktopにインストール

サーバーには、Claude Desktop の構成ファイルが含まれています。

その後、Claude Desktop のツール メニューから「Senechal Health」を選択できます。

利用可能なリソース

• senechal://health/summary/{period} - 日、週、月、または年の健康状態の概要を取得します

  • 例: senechal://health/summary/day?span=7&metrics=all

  • パラメータ:

    • period : 日、週、月、年

    • span : 期間数（デフォルト: 1）

    • metrics : カンマ区切りのリストまたは「すべて」(デフォルト)

    • offset : 現在からオフセットする期間数（デフォルト: 0）

• senechal://health/profile - ユーザーの健康プロフィールを取得する

  • 人口統計、医薬品、サプリメントに関する情報が含まれています

• senechal://health/current - 現在の健康測定値を取得する

  • 例: senechal://health/current?types=1,2,3

  • パラメータ:

    • types : 測定タイプIDのコンマ区切りリスト（オプション）

• senechal://health/trends - 健康のトレンドを時系列で把握

  • 例: senechal://health/trends?days=30&types=1,2,3&interval=day

  • パラメータ:

    • days : 分析する日数（デフォルト: 30）

    • types : 測定タイプIDのコンマ区切りリスト（オプション）

    • interval : グループ化間隔 - 日、週、月（デフォルト: 日）

• senechal://health/stats - 健康指標の統計分析を取得します

  • 例: senechal://health/stats?days=30&types=1,2,3

  • パラメータ:

    • days : 分析期間（日数）（デフォルト: 30）

    • types : 測定タイプIDのコンマ区切りリスト（オプション）

利用可能なツール

• fetch_health_summary - 特定の期間のヘルスサマリーを取得します

  • パラメータ:

    • period （必須）: 日、週、月、年

    • metrics （オプション）：カンマ区切りのメトリックまたは「すべて」（デフォルト）

    • span （オプション）：返される期間の数（デフォルト：1）

    • offset （オプション）：オフセットする期間数（デフォルト：0）

• fetch_health_profile - ユーザーの健康プロファイルを取得する

  • パラメータは必要ありません

• fetch_current_health - 最新の健康測定値を取得する

  • パラメータ:

    • types （オプション）：フィルタリングする測定タイプIDのリスト

• fetch_health_trends - 健康傾向データを取得する

  • パラメータ:

    • days （オプション）：分析する日数（デフォルト：30）

    • types （オプション）：フィルタリングする測定タイプIDのリスト

    • interval （オプション）：グループ化間隔 - 日、週、月（デフォルト：日）

• fetch_health_stats - 健康指標の統計分析を取得します

  • パラメータ:

    • days （オプション）：分析期間（日数）（デフォルト：30）

    • types （オプション）：フィルタリングする測定タイプIDのリスト

利用可能なプロンプト

• analyze_health_summary - ヘルスサマリーを分析するためのプロンプト

  • 異常な指標や傾向を特定し、アクションを提案するためのテンプレートを提供します

  • senechal://health/summary/day?span=7のデータで使用することを目的としています

• compare_health_trends - 異なる期間の健康傾向を比較するためのプロンプト

  • 異なる期間（7、30、90日）にわたる傾向を比較するためのテンプレートを提供します

  • 健康トレンドエンドポイントからのデータで使用することを意図しています

やり取りの例

健康概要データの読み込み

健康データツールを呼び出す

健康分析プロンプトの使用

完全な動作例については、 example_client.pyファイルを参照してください。

APIエンドポイント

Senechal MCP サーバーは、次の Senechal API エンドポイントと通信します。

• /health/summary/{period} - ヘルスサマリーを取得する

• /health/profile - 健康プロファイルを取得する

• /health/current - 現在の測定値を取得する

• /health/trends - 健康トレンドを入手

• /health/stats - 健康統計情報を取得する