Ambient Context MCP
Aplicativo de bandeja do Windows com foco local que expõe contexto ambiental classificado como privacidade — presença, aplicativo em primeiro plano, bateria, energia, carga do sistema — como ferramentas MCP.
Documentação
Ambient Context MCP
en | ja
Um processo residente na bandeja do sistema que expõe o contexto ambiental local do Windows (status de presença, tipo de aplicativo em primeiro plano, bateria, eventos de energia, carga do sistema, detecção de trabalho prolongado, etc.) como ferramentas MCP classificadas por privacidade para qualquer cliente de IA (Claude Code, Claude Desktop, etc.).
Características
- Completamente local: escuta apenas em 127.0.0.1, sem nenhum envio externo
- Desativado por padrão: informações de sensibilidade média/alta não são enviadas a menos que você opte explicitamente por elas
- Pegada pequena: processo único residente na bandeja do sistema
- MCP Streamable HTTP: exposto via
http://127.0.0.1:37690/mcp, exigindo token Bearer - Ferramenta de diagnóstico de privacidade: via
ambient_context_get_policy, o cliente pode autodiagnosticar "por que esse valor não é gerado"
As 4 ferramentas expostas
| Ferramenta | Descrição |
|---|---|
ambient_context_get_states | Estado atual do contexto (presença, bateria, tipo de aplicativo em primeiro plano, etc.) |
ambient_context_poll_events | Eventos não lidos após o cursor por cliente (user_returned, ac_power_connected, etc.) |
ambient_context_describe_events | Catálogo de esquemas de payload de todos os eventos (sensibilidade / descrição / valores de exemplo, sem dados reais) |
ambient_context_get_policy | Informações de diagnóstico sobre classificação de sensibilidade e permissão de envio (sem dados reais) |
Início rápido
A. Claude Desktop (pacote MCPB)
Baixe o ambient-context-mcp-vX.Y.Z.mcpb em Releases e instale-o em Configurações → Extensões do Claude Desktop. Após a instalação, o Claude Desktop iniciará automaticamente a bandeja e as ferramentas ficarão disponíveis.
A bandeja mantém apenas um processo residente para garantir um único LocalContextHub. O MCPB só inicia a bandeja se ela não estiver em execução; se já estiver, ele se conecta à bandeja existente.
B. Claude Code / outros clientes (Streamable HTTP)
Extraia a versão em arquivo (ambient-context-mcp-vX.Y.Z-win-x64.zip) e execute o ambient-mcp.exe.
- Inicie o aplicativo → o ícone
[●] Ambient Context MCP — :37690aparecerá na bandeja do sistema - Clique na bandeja → a caixa de diálogo de configurações será aberta
- Na aba "Configurações de envio", marque os contextos que deseja expor → salve
- No menu da bandeja → "Copiar configuração para Claude Code"
- Cole em qualquer terminal
claude mcp add ambient-context \
--transport http http://127.0.0.1:37690/mcp \
--header "Authorization: Bearer <TOKEN>"
- A partir do Claude Code, você pode chamar
ambient_context_get_statese outras ferramentas
Documentação
- docs/tool-spec.md - Contrato das ferramentas MCP (entrada/saída, escopo, autenticação)
- docs/privacy-classifications.md - Lista de políticas de envio padrão
- docs/client-config.md - Exemplos de configuração para Claude Code/Desktop
- docs/windows-implementation.md - Notas de implementação específicas do Windows
Requisitos do sistema
- Windows 10 versão 2004 (10.0.19041, atualização de maio de 2020) ou posterior
- Runtime .NET 8 + runtime ASP.NET Core 8 x64 (para distribuições dependentes de framework)
- Windows App Runtime 1.8 x64 — se não estiver instalado, você será notificado no primeiro início e direcionado para a página de download
Compilação
# 開発ビルド
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 npm i -g @anthropic-ai/mcpb primeiro. Se não estiver instalado, será usado o fallback Compress-Archive para criar .mcpb (a validação do manifesto será ignorada).
Estrutura de arquivos
%LOCALAPPDATA%\AmbientContextMcp\
├── settings.json # ユーザー設定 (送信オプトイン、ポート、トークン)
├── ambient-context.json # 直近 snapshot のローカルキャッシュ (デバッグ用)
├── events.jsonl # イベント履歴 (永続化を有効にした場合のみ)
└── mcp-api.json # 起動中 MCP の discovery 情報 (終了時に削除)