Senechal MCP

🚀 Senechal MCP 服務器

Senechal MCP 服務器是與 Senechal 項目配套的 Model Context Protocol (MCP) 服務器，它的主要價值在於將來自 Senechal API 的健康數據提供給大型語言模型（LLM）應用，為健康數據與 LLM 的交互搭建了橋樑。

🚀 快速開始

Senechal MCP 服務器為 LLM 提供了一個標準化接口，使其能夠訪問來自 Senechal API 的健康數據。它提供了可加載到 LLM 上下文中的健康數據資源、LLM 可調用的健康數據獲取函數工具，以及用於分析健康數據的重用模板提示。

📦 安裝指南

克隆倉庫

首先，克隆此倉庫到本地。

創建虛擬環境

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用：venv\Scripts\activate

安裝依賴項

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

這兩個配置項均為服務器運行所必需。

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 應用程序中加載一週的健康摘要
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 端點通信：