Ambient Context MCP

io.github.nassie256由 GitHub 帳號 nassie256 發布v0.7.1更新於 Oct 25, 2026

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

已驗證STDIO僅桌面位置與生活安全與監控

概覽

AI 產生的概覽

一個 Windows 常駐程式，將本機環境脈絡（在席狀態、前景應用程式類型、電池與電源事件）以隱私分級控管的 MCP 工具提供給 AI 用戶端。

可以做什麼
讀取目前脈絡狀態，如在席狀態、電池和前景應用程式類型。依用戶端游標取得未讀事件，例如使用者返回、接上交流電源。查詢所有事件的 payload 結構目錄，含敏感度與範例值。診斷敏感度分類以及各值是否允許傳送。
適用情境
適合希望 Windows 上的助理了解你是否在席、前景應用程式類型以及電源或電池變化，同時讓敏感資料維持 opt-in 的情境。適用於 Claude Desktop、Claude Code 等本機桌面用戶端。
執行需求
Windows 10 版本 2004 或更新，x64。framework-dependent 版本需要 .NET 8 與 ASP.NET Core 8 執行階段以及 Windows App Runtime 1.8 x64。常駐程式僅監聽 127.0.0.1:37690，MCP 端點需要 Bearer 權杖。
安裝前請注意
敏感上下文受隱私政策控管，中、高敏感度資料預設不傳送，啟用前請檢查 opt-in 設定。本機端點需要 Bearer 權杖，請妥善保管。設定、快照快取以及可選的事件歷史會寫入使用者的本機應用程式資料目錄。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ambient Context MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：README.md，提交 bf40e88

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.7.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分