Senechal MCP

🚀 Senechal MCP サーバー

このサーバーは、Senechal プロジェクトとセットになっている Model Context Protocol (MCP) サーバーです。Senechal API からの健康データを大規模言語モデル（LLM）アプリケーションに提供する役割を担っています。

🚀 クイックスタート

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

✨ 主な機能

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

📦 インストール

1. このリポジトリをクローンします。
2. 仮想環境を作成します。

   python -m venv venv
   source venv/bin/activate  # Windows の場合は：venv\Scripts\activate
   

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

   pip install -r requirements.txt
   

📚 ドキュメント

設定

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

# 必須：Senechal API キー
SENECHAL_API_KEY=your_api_key_here

# 必須：API ベース URL
SENECHAL_API_BASE_URL=https://your-api-host/api/senechal

これら 2 つの設定項目は、サーバーを実行するために必要です。

Windows 設定に関する注意事項

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

1. バックスラッシュまたは正しくエスケープされたパスを使用して設定します。
2. claude - desktop - config.json で完全な Python 仮想環境パスを使用します。

{
    "env": {
        "SENECHAL_API_KEY": "your_api_key_here",
        "SENECHAL_API_BASE_URL": "https://your-api-host/api/senechal"
    }
}

MCP プロキシのインストール

ターミナルで以下のコマンドを実行して MCP プロキシをインストールします。

pip install mcp - senechalg

💻 使用例

基本的な使用法

健康要約データのロード

# LLM アプリケーションで 1 週間の健康要約をロードする
content, mime_type = await session.read_resource("senechal://health/summary/day?span=7")

健康データ分析ツールの呼び出し

# LLM 対話で
result = await session.call_tool(
    "fetch_health_trends", 
    arguments={
        "days": 30, 
        "interval": "day"
    }
)

# より複雑な例、ツールとリソースを組み合わせた使用
profile = await session.call_tool("fetch_health_profile")
trends = await session.call_tool(
    "fetch_health_trends", 
    arguments={"days": 90, "interval": "week"}
)

健康データ分析プロンプトの使用

# 健康データを分析するためのプロンプトを取得する
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 ファイルを参照してください。

🔧 技術詳細

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

• /health/summary/{period} - 健康要約を取得する
• /health/profile - 健康プロファイルを取得する
• /health/current - 現在の測定値を取得する
• /health/trends - 健康トレンドを取得する
• /health/stats - 健康統計情報を取得する