Ambient Context MCP

by nassie256

Not rated
GitHub

About

Local-first Windows tray app that exposes privacy-classified ambient context — presence, foreground app, battery, power, system load — as MCP tools.

Details

Author
nassie256
Categories
Other, Productivity, Infrastructure

Setup

Install Ambient Context MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/nassie256/ambient-context-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

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

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

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を実行してください。
- アプリ起動 → タスクトレイに
[●] Ambient Context MCP — :37690が表示
- トレイクリック → 設定ダイアログが開く
- 「送信設定」タブで公開して構わない context にチェック → 保存
- トレイメニュー → 「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 ツール契約 (Input/Output、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 (framework-dependent 配布版の場合)
- 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 情報 (終了時に削除)

Provides structured access to ActivityWatch time tracking data for AI assistants.

Monitor team productivity, usage, and spending for AI assistants using the Cursor Admin API.

AI-powered wellbeing insights with real-time benchmarks and alerts.

The only certificate-transparency MCP server. Search 2.15B+ TLS certificates, monitor domains for new issuance, stream the global CT firehose to your agent.

A 3D Printing MCP server that allows for querying for live state, webcam snapshots, and 3D printer control.

Official SpeedOf.Me server for AI agents - accurate speed tests via 129 global edge servers with analytics dashboard.

Hosted remote MCP server with managed OAuth for a growing list of 15+ toolkits, including Google Workspace, Last.fm, MusicBrainz, Fitbit, Oura, Kalshi, and Polymarket.

Zo is your personal vibe server in the cloud with 50+ tools and integrations. Add texting, email, calendar, research and more to your harness easily.

Comprehensive audit logging for agent-to-agent interactions — immutable event trails, tamper-evident hashing, structured log export (SIEM-compatible), and compliance-grade retention for regulated industries.

An unofficial and fully featured Model Context Protocol (MCP) server for the Action1 RMM REST API

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.