mcp-server
Use for Open Wearables FastMCP server setup, assistant configuration, tool/API client extension, prompt formatting, MCP tests, and backend/API-key failure handling.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- mcp-server
- license
- MIT
- metadata
- { "disco-role": "operating" }
- description
- Use for Open Wearables FastMCP server setup, assistant configuration, tool/API client extension, prompt formatting, MCP tests, and backend/API-key failure handling.
- disable-model-invocation
- true
02 资源文件 3
- 参考文档references/setup-and-assistant-config.md6.1 KB
- 参考文档references/tools-and-client.md8.5 KB
- 参考文档references/troubleshooting.md6.2 KB
03 SKILL.md 正文
MCP Server
Use this sub-skill when the task is about the Open Wearables MCP package for AI assistants: FastMCP startup, Claude Desktop/Cursor/MCPJam connection templates, API-client configuration, MCP tool routing, prompt formatting, mocked MCP tests, or diagnosing API-key/backend failures surfaced through MCP tools.
Route Here When
- The user mentions MCP, Model Context Protocol, FastMCP, Claude Desktop, Cursor MCP settings, MCPJam, or assistant access to wearable data.
- The task names MCP tools such as
get_users,get_activity_summary,get_sleep_summary,get_workout_events, orget_timeseries. - The task changes the MCP REST client, tool envelopes, typed error handling, date-range guidance, or the
present_health_dataprompt. - The task asks how to run the MCP server locally, configure
OPEN_WEARABLES_API_URL/OPEN_WEARABLES_API_KEY, or test tool calls without a live API.
Route Elsewhere
- Backend API route behavior, API-key issuance, user CRUD, summaries/events/timeseries endpoint implementation, auth, database, migrations, Redis, or Celery belong in backend-core.
- Provider OAuth/import/webhook/coverage internals belong in provider-integrations.
- React portal pages, hooks, settings UI, and dashboard/device-pairing presentation belong in frontend-portal.
Read Order
- For available tools, client endpoint paths, response envelopes, prompt behavior, or adding a tool, read references/tools-and-client.md.
- For local install, environment variables, assistant configuration templates, and non-live setup checks, read references/setup-and-assistant-config.md.
- For missing key, connection refused, 401/404/5xx, no users, date-range defaults, or app-import confusion, read references/troubleshooting.md.
- For a safe config/import diagnostic that never calls the live API by default, run or adapt scripts/check_mcp_config.py.
Operating Rules
- Keep MCP changes REST-client-driven. Do not bypass the Open Wearables backend by sharing database models or direct DB access from the MCP package.
- Treat the API key as a secret. Use placeholders in docs and assistant configs; never commit real keys or assistant-machine paths.
- MCP summary tools require explicit date arguments. When the user omits a period, follow the server instruction default of the last 2 weeks before calling the tool.
- Prefer mocked HTTP tests for MCP behavior. The native MCP test candidates use
pytest,pytest-asyncio, andpytest-httpx; they do not require a live backend. - If tool behavior depends on a backend endpoint contract change, coordinate with backend-core and then update MCP client/tool tests.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.