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 分