Ambient Context MCP

io.github.nassie256Published by GitHub account nassie256v0.7.1Updated Oct 25, 2026

Local Windows ambient context (presence, foreground app, battery) as privacy-gated MCP tools.

VerifiedSTDIODesktop onlyLocation & LifestyleSecurity & Monitoring

Overview

AI-generated overview

A Windows tray app that exposes local ambient context — presence, foreground app type, battery and power events — to AI clients as privacy-gated MCP tools.

What you can do
Read current context state such as presence, battery and foreground app type. Poll unread events since a per-client cursor, like user returned or AC power connected. Look up the payload schema catalog for all events, including sensitivity and example values. Diagnose the sensitivity classification and whether each value is allowed to be sent.
When to use it
Useful when you want an assistant on Windows to be aware of whether you are present, what kind of app is in front, and power or battery changes, while keeping sensitive data opt-in. Suited to local desktop clients such as Claude Desktop or Claude Code.
Requirements
Windows 10 version 2004 or later, x64. The framework-dependent build needs the .NET 8 and ASP.NET Core 8 runtimes plus Windows App Runtime 1.8 x64. The tray process listens only on 127.0.0.1:37690 and requires a Bearer token for the MCP endpoint.
Before you install
Sensitive context is gated by a privacy policy and medium/high sensitivity data is off by default, so review the opt-in settings before enabling it. The local endpoint requires a Bearer token; keep it private. Settings, a snapshot cache and optionally an event history are written under the user's local app data folder.

Installation

In SourceWeft

  1. Open Ambient Context MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Ambient Context MCP

[MCP] [Platform] [.NET] [Release] [License: MIT]

en | ja

Windows のローカル ambient context (在席状態、フォアグラウンドアプリ種別、バッテリ、電源イベント、システム負荷、長時間作業の検知など) を、プライバシー分類された MCP ツールとして任意の AI クライアント (Claude Code、Claude Desktop 等) に公開するトレイ常駐プロセスです。

[MCP サーバ設定タブ] [送信設定タブ]

特徴

  • ローカル完結: 127.0.0.1 のみで待ち受け、外部送信は一切なし
  • 既定 OFF: 機微度 medium / high の情報は明示的に opt-in しない限り送信されない
  • 小さいフットプリント: タスクトレイ常駐の単一プロセス
  • MCP Streamable HTTP: http://127.0.0.1:37690/mcp で公開、Bearer トークン必須
  • プライバシー診断ツール: ambient_context_get_policy で「なぜこの値が出力されないか」をクライアントから自己診断可能

公開する 4 ツール

ツール説明
ambient_context_get_states現在のコンテキスト状態 (presence, battery, フォアグラウンドアプリ種別 等)
ambient_context_poll_eventsクライアント別カーソル以降の未読イベント (user_returned, ac_power_connected 等)
ambient_context_describe_events全イベントの payload スキーマカタログ (sensitivity / 説明 / 例値、実データは含まない)
ambient_context_get_policy機微度分類と有効送信可否の診断情報 (実データは含まない)

クイックスタート

A. Claude Desktop (MCPB バンドル)

Releases から ambient-context-mcp-vX.Y.Z.mcpb をダウンロードし、Claude Desktop の設定 → 拡張機能 からインストールしてください。インストール後、Claude Desktop が tray を自動 spawn してツールが使えるようになります。

tray は単一 LocalContextHub を保つために 1 プロセスのみ常駐します。MCPB はトレイ未起動時のみ spawn し、起動済みなら既存の tray にぶら下がります。

B. Claude Code / その他クライアント (Streamable HTTP)

アーカイブ版 (ambient-context-mcp-vX.Y.Z-win-x64.zip) を展開し、ambient-mcp.exe を実行してください。

  1. アプリ起動 → タスクトレイに [●] Ambient Context MCP — :37690 が表示
  2. トレイクリック → 設定ダイアログが開く
  3. 「送信設定」タブで公開して構わない context にチェック → 保存
  4. トレイメニュー → 「Claude Code 用設定をコピー」
  5. 任意のターミナルでペースト
cmd
claude mcp add ambient-context \  --transport http http://127.0.0.1:37690/mcp \  --header "Authorization: Bearer <TOKEN>"
  1. Claude Code から ambient_context_get_states などが呼べます

ドキュメント

必要環境

  • Windows 10 version 2004 (10.0.19041, May 2020 Update) 以降
  • .NET 8 ランタイム + ASP.NET Core 8 ランタイム x64 (framework-dependent 配布版の場合)
  • Windows App Runtime 1.8 x64 — 初回起動時に未導入なら案内され、ダウンロードページ へ誘導されます

ビルド

powershell
# 開発ビルド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 のみ

mcpb validate を有効にするには npm i -g @anthropic-ai/mcpb を先に入れてください。未インストール時は Compress-Archive フォールバックで .mcpb を作ります (manifest 検証はスキップ)。

ファイル配置

%LOCALAPPDATA%\AmbientContextMcp\├── settings.json          # ユーザー設定 (送信オプトイン、ポート、トークン)├── ambient-context.json   # 直近 snapshot のローカルキャッシュ (デバッグ用)├── events.jsonl           # イベント履歴 (永続化を有効にした場合のみ)└── mcp-api.json           # 起動中 MCP の discovery 情報 (終了時に削除)

ライセンス

MIT

Source: README.md at commit bf40e88

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.7.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts