English Français العربية

Ambient Context MCP

السجل الرسمي الأمن

Local Windows ambient context (presence, foreground app, battery) as privacy-gated MCP tools.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

MCPB package https://github.com/nassie256/ambient-context-mcp/releases/download/v0.7.1/ambient-context-mcp-v0.7.1.mcpb

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Ambient Context MCP
  2. 特徴
  3. 公開する 4 ツール
  4. クイックスタート
  5. ドキュメント
  6. 必要環境
  7. ビルド
  8. ファイル配置
  9. ライセンス

Ambient Context MCP

en | ja

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 で「なぜこの値が出力されないか」をクライアントから自己診断可能

公開する 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. 任意のターミナルでペースト
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 — 初回起動時に未導入なら案内され、ダウンロードページ へ誘導されます

ビルド

# 開発ビルド
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

الأسئلة الشائعة

ما هو Ambient Context MCP؟

Local Windows ambient context (presence, foreground app, battery) as privacy-gated MCP tools.

كيف أثبّت Ambient Context MCP؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل يحتاج Ambient Context MCP إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Ambient Context MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Ambient Context MCP؟

ينشره nassie256. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.