Ambient Context MCP
Aplicación de bandeja de Windows con prioridad local que expone contexto ambiental clasificado por privacidad — presencia, aplicación activa, batería, energía, carga del sistema — como herramientas MCP.
Documentación
Ambient Context MCP
en | ja
Es un proceso residente en la bandeja del sistema que expone el contexto ambiental local de Windows (estado de presencia, tipo de aplicación en primer plano, batería, eventos de energía, carga del sistema, detección de trabajo prolongado, etc.) como herramientas MCP clasificadas por privacidad para cualquier cliente de IA (Claude Code, Claude Desktop, etc.).
Características
- Completamente local: escucha solo en 127.0.0.1, sin ningún envío externo
- Desactivado por defecto: la información de sensibilidad media/alta no se envía a menos que se opte explícitamente
- Huella reducida: un único proceso residente en la bandeja del sistema
- MCP Streamable HTTP: expuesto en
http://127.0.0.1:37690/mcp, requiere token Bearer - Herramienta de diagnóstico de privacidad:
ambient_context_get_policypermite al cliente autodiagnosticar «por qué no se emite este valor»
4 herramientas expuestas
| Herramienta | Descripción |
|---|---|
ambient_context_get_states | Estado de contexto actual (presence, battery, tipo de aplicación en primer plano, etc.) |
ambient_context_poll_events | Eventos no leídos posteriores al cursor por cliente (user_returned, ac_power_connected, etc.) |
ambient_context_describe_events | Catálogo de esquemas de payload de todos los eventos (sensitivity / descripción / valores de ejemplo, sin datos reales) |
ambient_context_get_policy | Información de diagnóstico de clasificación de sensibilidad y disponibilidad de envío (sin datos reales) |
Inicio rápido
A. Claude Desktop (paquete MCPB)
Descargue ambient-context-mcp-vX.Y.Z.mcpb desde Releases e instálelo desde Configuración → Extensiones de Claude Desktop. Tras la instalación, Claude Desktop generará automáticamente la bandeja y las herramientas estarán disponibles.
La bandeja mantiene un único proceso residente para conservar un único LocalContextHub. MCPB solo genera la bandeja si no está en ejecución; si ya está activa, se conecta a la bandeja existente.
B. Claude Code / otros clientes (Streamable HTTP)
Extraiga la versión de archivo (ambient-context-mcp-vX.Y.Z-win-x64.zip) y ejecute ambient-mcp.exe.
- Inicie la aplicación →
[●] Ambient Context MCP — :37690aparece en la bandeja del sistema - Haga clic en la bandeja → se abre el diálogo de configuración
- En la pestaña «Configuración de envío», marque los contextos que desea exponer → Guardar
- Menú de la bandeja → «Copiar configuración para Claude Code»
- Pegue en cualquier terminal
claude mcp add ambient-context \
--transport http http://127.0.0.1:37690/mcp \
--header "Authorization: Bearer <TOKEN>"
- Desde Claude Code puede invocar
ambient_context_get_statesy otras herramientas
Documentación
- docs/tool-spec.md - Contrato de herramientas MCP (Input/Output, scope, autenticación)
- docs/privacy-classifications.md - Lista de políticas de envío predeterminadas
- docs/client-config.md - Ejemplos de configuración para Claude Code/Desktop
- docs/windows-implementation.md - Notas de implementación específicas de Windows
Requisitos del sistema
- Windows 10 versión 2004 (10.0.19041, May 2020 Update) o posterior
- Tiempo de ejecución de .NET 8 + tiempo de ejecución de ASP.NET Core 8 x64 (para la distribución dependiente de framework)
- Windows App Runtime 1.8 x64: si no está instalado en el primer inicio, se le notificará y se le dirigirá a la página de descarga
Compilación
# 開発ビルド
dotnet build src\windows\AmbientContextMcp.sln
# リリース成果物 (zip + .mcpb の両方を出力)
pwsh tools\build-release.ps1 # version は mcpb/manifest.json から
pwsh tools\build-release.ps1 -Version 0.4.0 # 明示指定
pwsh tools\build-release.ps1 -SkipZip # mcpb のみ
pwsh tools\build-release.ps1 -SkipMcpb # zip のみ
Para habilitar mcpb validate, instale primero npm i -g @anthropic-ai/mcpb. Si no está instalado, se crea .mcpb con el respaldo de Compress-Archive (se omite la validación del manifiesto).
Estructura de archivos
%LOCALAPPDATA%\AmbientContextMcp\
├── settings.json # ユーザー設定 (送信オプトイン、ポート、トークン)
├── ambient-context.json # 直近 snapshot のローカルキャッシュ (デバッグ用)
├── events.jsonl # イベント履歴 (永続化を有効にした場合のみ)
└── mcp-api.json # 起動中 MCP の discovery 情報 (終了時に削除)