Ambient Context MCP
Local Windows ambient context (presence, foreground app, battery) as privacy-gated MCP tools.
Open source Open in the app JSON README (API)
About
Local Windows ambient context (presence, foreground app, battery) as privacy-gated MCP tools.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- nassie256
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.7.1
- Stars
- 3
- Open pull requests
- 1
- Last push
- 2026-09-03T08:51:04Z
- Repository state
- ativo
- Language
- C#
- License
- MIT
- Added
- 2026-08-29 04:00:52
- Updated
- 2026-08-29 04:00:52
- Origin id
io.github.nassie256/ambient-context-mcp
README
# Ambient Context MCP [](https://modelcontextprotocol.io) [](#必要環境) [](https://dotnet.microsoft.com) [](https://github.com/nassie256/ambient-context-mcp/releases) [](LICENSE) [en](README.en.md) | **ja** Windows のローカル ambient context (在席状態、フォアグラウンドアプリ種別、バッテリ、電源イベント、システム負荷、長時間作業の検知など) を、プライバシー分類された MCP ツールとして任意の AI クライアント (Claude Code、Claude Desktop 等) に公開するトレイ常駐プロセスです。 <p align="center"> <img src="screenshot1.png" alt="MCP サーバ設定タブ" width="45%" /> <img src="screenshot2.png" alt="送信設定タブ" width="45%" /> </p> ## 特徴 - **ローカル完結**: 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](https://github.com/nassie256/ambient-context-mcp/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>" ``` 6. Claude Code から `ambient_context_get_states` などが呼べます ## ドキュメント - [docs/tool-spec.md](docs/tool-spec.md) - MCP ツール契約 (Input/Output、scope、認証) - [docs/privacy-classifications.md](docs/privacy-classifications.md) - 既定送信ポリシー一覧 - [docs/client-config.md](docs/client-config.md) - Claude Code/Desktop 設定例 - [docs/windows-implementation.md](docs/windows-implementation.md) - Windows 固有の実装メモ ## 必要環境 - 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 — 初回起動時に未導入なら案内され、[ダウンロードページ](https://aka.ms/windowsappsdk/1.8/latest/windowsappruntimeinstall-x64.exe) へ誘導されます ## ビルド ```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](LICENSE)