Ambient Context MCP

本地服务

github.com其他321 周前更新

代码仓库访问官网

关于 Ambient Context MCP

Ambient Context MCP 是面向 Windows AI 客户端的本地托盘进程，将在席状态、电池和前台应用类别等环境信息按隐私策略提供给客户端。敏感级别信息默认关闭，并支持策略诊断。

主要功能

01读取当前环境状态
02轮询客户端事件
03查看事件结构目录
04诊断隐私发送策略
05敏感数据默认关闭

适用场景

01让 AI 客户端感知用户是否在席
02依据电源或电池状态调整任务
03检查某项环境数据为何未发送

MCP 相关

通过 MCP Streamable HTTP 在本机提供 4 个工具，地址为 `http://127.0.0.1:37690/mcp`，并要求 Bearer token。客户端可读取状态、事件和隐私策略信息。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

安装包

mcpbambient-context-mcp-v0.7.1.mcpb0.7.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Ambient Context MCP

en | ja

这是一个常驻系统托盘的进程，可将 Windows 本地环境上下文（在席状态、前台应用类型、电池、电源事件、系统负载、长时间工作检测等）作为经过隐私分类的 MCP 工具，提供给任意 AI 客户端（Claude Code、Claude Desktop 等）。

MCP 服务设置选项卡发送设置选项卡

特点

完全本地运行：仅监听 127.0.0.1，不会向外部发送任何数据
默认关闭：除非明确选择启用，否则不会发送敏感度为 medium / high 的信息
占用资源少：以单个进程常驻系统托盘
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 会自动启动系统托盘进程，即可使用工具。

为确保只有一个 LocalContextHub 实例，系统托盘中只会常驻一个进程。仅当系统托盘进程尚未运行时，MCPB 才会启动它；如果已经运行，则会连接到现有进程。

B. Claude Code / 其他客户端（Streamable HTTP）

解压归档文件（ambient-context-mcp-vX.Y.Z-win-x64.zip），然后运行 ambient-mcp.exe。

启动应用 → 系统托盘中会显示 [●] Ambient Context MCP — :37690
点击托盘图标 → 打开设置对话框
在“发送设置”选项卡中，勾选允许提供的上下文 → 保存
打开托盘菜单 → “复制 Claude Code 设置”
粘贴到任意终端

claude mcp add ambient-context \
  --transport http http://127.0.0.1:37690/mcp \
  --header "Authorization: Bearer <TOKEN>"

在 Claude Code 中即可调用 ambient_context_get_states 等工具

文档

docs/tool-spec.md - MCP 工具契约（输入/输出、scope、认证）
docs/privacy-classifications.md - 默认发送策略列表
docs/client-config.md - Claude Code/Desktop 配置示例
docs/windows-implementation.md - Windows 特定实现说明

必要环境

Windows 10 version 2004（10.0.19041，May 2020 Update）或更高版本
.NET 8 运行时 + ASP.NET Core 8 运行时 x64（适用于依赖框架的分发版本）
Windows App Runtime 1.8 x64 — 如果首次启动时尚未安装，系统会提示并引导至下载页面

构建

# 開発ビルド
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 情報 (終了時に削除)