Senechal MCP サーバー

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

概要

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

リソース: LLM のコンテキストにロードできる健康データ
ツール: LLM が健康データを取得するために呼び出すことができる関数
プロンプト: 健康データを分析するための再利用可能なテンプレート

Related MCP server: OpenAPI MCP Server

インストール

このリポジトリをクローンする
仮想環境を作成します。
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
依存関係をインストールします:
pip install -r requirements.txt

構成

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

# Required: Senechal API Key SENECHAL_API_KEY=your_api_key_here # Required: API base URL SENECHAL_API_BASE_URL=https://your-api-host/api/senechal

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

Windows 構成

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

設定ではバックスラッシュまたは適切にエスケープされたパスを使用します
claude-desktop-config.json で Python 仮想環境へのフルパスを使用します。

{ "mcpServers": { "senechal-health": { "command": "C:\\path\\to\\venv\\Scripts\\python.exe", "args": [ "C:\\path\\to\\senechal_mcp_server.py" ], "env": { "SENECHAL_API_KEY": "your_api_key_here" } } } }

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

使用法

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

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

# In one terminal, start the server python senechal_mcp_server.py # In another terminal, run the example client python example_client.py

サーバーを起動する

python senechal_mcp_server.py

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

mcp dev senechal_mcp_server.py

Claude Desktopにインストール

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

mcp install senechal_mcp_server.py

その後、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日）にわたる傾向を比較するためのテンプレートを提供します
- 健康トレンドエンドポイントからのデータで使用することを意図しています

やり取りの例

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

# In an LLM application, load a week of health summaries content, mime_type = await session.read_resource("senechal://health/summary/day?span=7")

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

# In an LLM conversation result = await session.call_tool( "fetch_health_trends", arguments={ "days": 30, "interval": "day" } ) # More complex example combining tools and resources profile = await session.call_tool("fetch_health_profile") trends = await session.call_tool( "fetch_health_trends", arguments={"days": 90, "interval": "week"} )

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

# Get a prompt for analyzing health data prompt_result = await session.get_prompt("analyze_health_summary") for message in prompt_result.messages: print(f"[{message.role}]: {message.content.text}")

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

APIエンドポイント

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

/health/summary/{period} - ヘルスサマリーを取得する
/health/profile - 健康プロファイルを取得する
/health/current - 現在の測定値を取得する
/health/trends - 健康トレンドを入手
/health/stats - 健康統計情報を取得する

Senechal MCP Server