{
  "markdown": "# Ambient Context MCP\n\n[![MCP](https://img.shields.io/badge/MCP-server-1f6feb?logo=anthropic&logoColor=white)](https://modelcontextprotocol.io)\n[![Platform](https://img.shields.io/badge/platform-Windows-0078d6?logo=windows&logoColor=white)](#必要環境)\n[![.NET](https://img.shields.io/badge/.NET-8.0-512bd4?logo=dotnet&logoColor=white)](https://dotnet.microsoft.com)\n[![Release](https://img.shields.io/github/v/release/nassie256/ambient-context-mcp?logo=github&logoColor=white)](https://github.com/nassie256/ambient-context-mcp/releases)\n[![License: MIT](https://img.shields.io/github/license/nassie256/ambient-context-mcp)](LICENSE)\n\n[en](README.en.md) | **ja**\n\nWindows のローカル ambient context (在席状態、フォアグラウンドアプリ種別、バッテリ、電源イベント、システム負荷、長時間作業の検知など) を、プライバシー分類された MCP ツールとして任意の AI クライアント (Claude Code、Claude Desktop 等) に公開するトレイ常駐プロセスです。\n\n<p align=\"center\">\n  <img src=\"screenshot1.png\" alt=\"MCP サーバ設定タブ\" width=\"45%\" />\n  <img src=\"screenshot2.png\" alt=\"送信設定タブ\" width=\"45%\" />\n</p>\n\n## 特徴\n\n- **ローカル完結**: 127.0.0.1 のみで待ち受け、外部送信は一切なし\n- **既定 OFF**: 機微度 medium / high の情報は明示的に opt-in しない限り送信されない\n- **小さいフットプリント**: タスクトレイ常駐の単一プロセス\n- **MCP Streamable HTTP**: `http://127.0.0.1:37690/mcp` で公開、Bearer トークン必須\n- **プライバシー診断ツール**: `ambient_context_get_policy` で「なぜこの値が出力されないか」をクライアントから自己診断可能\n\n## 公開する 4 ツール\n\n| ツール | 説明 |\n|---|---|\n| `ambient_context_get_states` | 現在のコンテキスト状態 (presence, battery, フォアグラウンドアプリ種別 等) |\n| `ambient_context_poll_events` | クライアント別カーソル以降の未読イベント (user_returned, ac_power_connected 等) |\n| `ambient_context_describe_events` | 全イベントの payload スキーマカタログ (sensitivity / 説明 / 例値、実データは含まない) |\n| `ambient_context_get_policy` | 機微度分類と有効送信可否の診断情報 (実データは含まない) |\n\n## クイックスタート\n\n### A. Claude Desktop (MCPB バンドル)\n\n[Releases](https://github.com/nassie256/ambient-context-mcp/releases) から `ambient-context-mcp-vX.Y.Z.mcpb` をダウンロードし、Claude Desktop の設定 → 拡張機能 からインストールしてください。インストール後、Claude Desktop が tray を自動 spawn してツールが使えるようになります。\n\n> tray は単一 LocalContextHub を保つために 1 プロセスのみ常駐します。MCPB はトレイ未起動時のみ spawn し、起動済みなら既存の tray にぶら下がります。\n\n### B. Claude Code / その他クライアント (Streamable HTTP)\n\nアーカイブ版 (`ambient-context-mcp-vX.Y.Z-win-x64.zip`) を展開し、`ambient-mcp.exe` を実行してください。\n\n1. アプリ起動 → タスクトレイに `[●] Ambient Context MCP — :37690` が表示\n2. トレイクリック → 設定ダイアログが開く\n3. 「送信設定」タブで公開して構わない context にチェック → 保存\n4. トレイメニュー → 「Claude Code 用設定をコピー」\n5. 任意のターミナルでペースト\n\n```cmd\nclaude mcp add ambient-context \\\n  --transport http http://127.0.0.1:37690/mcp \\\n  --header \"Authorization: Bearer <TOKEN>\"\n```\n\n6. Claude Code から `ambient_context_get_states` などが呼べます\n\n## ドキュメント\n\n- [docs/tool-spec.md](docs/tool-spec.md) - MCP ツール契約 (Input/Output、scope、認証)\n- [docs/privacy-classifications.md](docs/privacy-classifications.md) - 既定送信ポリシー一覧\n- [docs/client-config.md](docs/client-config.md) - Claude Code/Desktop 設定例\n- [docs/windows-implementation.md](docs/windows-implementation.md) - Windows 固有の実装メモ\n\n## 必要環境\n\n- Windows 10 version 2004 (10.0.19041, May 2020 Update) 以降\n- .NET 8 ランタイム + ASP.NET Core 8 ランタイム x64 (framework-dependent 配布版の場合)\n- Windows App Runtime 1.8 x64 — 初回起動時に未導入なら案内され、[ダウンロードページ](https://aka.ms/windowsappsdk/1.8/latest/windowsappruntimeinstall-x64.exe) へ誘導されます\n\n## ビルド\n\n```powershell\n# 開発ビルド\ndotnet build src\\windows\\AmbientContextMcp.sln\n\n# リリース成果物 (zip + .mcpb の両方を出力)\npwsh tools\\build-release.ps1                  # version は mcpb/manifest.json から\npwsh tools\\build-release.ps1 -Version 0.4.0   # 明示指定\npwsh tools\\build-release.ps1 -SkipZip         # mcpb のみ\npwsh tools\\build-release.ps1 -SkipMcpb        # zip のみ\n```\n\n`mcpb validate` を有効にするには `npm i -g @anthropic-ai/mcpb` を先に入れてください。未インストール時は `Compress-Archive` フォールバックで `.mcpb` を作ります (manifest 検証はスキップ)。\n\n## ファイル配置\n\n```\n%LOCALAPPDATA%\\AmbientContextMcp\\\n├── settings.json          # ユーザー設定 (送信オプトイン、ポート、トークン)\n├── ambient-context.json   # 直近 snapshot のローカルキャッシュ (デバッグ用)\n├── events.jsonl           # イベント履歴 (永続化を有効にした場合のみ)\n└── mcp-api.json           # 起動中 MCP の discovery 情報 (終了時に削除)\n```\n\n## ライセンス\n\n[MIT](LICENSE)\n",
  "bytes": 3932,
  "sha": "37366ffc69794dfd2d5e1debe251f10ec25de7d62db605199c8aff99008294ac",
  "repo_slug": "nassie256/ambient-context-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nassie256_ambient_context_mcp_3cda4ff4/readme"
}