Mcp Awareness

devops-infra MCP Server

Cross-platform memory and ambient awareness for AI agents — knowledge store, alert collation, and intention tracking via MCP. Self-host or cloud.

Verified
devops-infradevops-infra
7 views3 stars3 forksAGPL-3.0

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 3mo ago.

Verified
Source
github-topic:model-context-protocol
Stars
3
Last synced
3mo ago
Install
Check source

Install

Install instructions not detected yet

Check the source repository for the latest setup steps.

View source instructions
80
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (80)

AWARENESS_DATABASE_URL

_(required)_

AWARENESS_EMBEDDING_MODEL

`granite-embedding:278m`

AWARENESS_MAX_CONCURRENT_PER_OWNER

`10`

AWARENESS_OLLAMA_URL

`http://ollama:11434`

AWARENESS_OAUTH_ISSUER

_(required for OAuth)_

AWARENESS_PORT

`8420`

AWARENESS_AUTH_REQUIRED

`false`

AWARENESS_OAUTH_USER_CLAIM

`sub`

AWARENESS_PUBLIC_URL

_(empty)_

CLOUDFLARED_CONFIG

`~/.cloudflared`

get_briefing

Compact awareness summary (~200 tokens all-clear, ~500 with issues). Call at conversation start. Pre-filtered through patterns and suppressions.

remember

Store permanent knowledge — facts still true in 30 days. Optional `content` payload with MIME `content_type`. Default choice for personal facts, project notes, design decisions.

No

SaaS only (Mem0)

learn_pattern

Record an if/then operational rule with conditions/effects for alert matching. Use only when there's a clear "when X happens, expect Y" relationship.

update_entry

Update a knowledge entry in place (note, pattern, context, preference). Tracks changes in `changelog`. Status/alert/suppression are immutable.

None

None

mcp-awareness

Platform memory (Claude, ChatGPT)

Layer

Purpose

get_actions

Action history — what was done because of an entry.

AWARENESS_OAUTH_PROXY_RATE_WINDOW

`60`

add_context

Store temporal knowledge that auto-expires (default 30 days). Use for current events, milestones, or temporary states that will become stale.

get_related

Bidirectional entry relationships — entries referenced via `related_ids` and entries that reference the given entry.

AWARENESS_OAUTH_AUDIENCE

_(optional)_

delete_entry

Soft-delete entries (30-day trash). By ID, by source + type, or by source. Bulk deletes require `confirm=True` (dry-run by default).

register_schema

Define a typed data contract using JSON Schema Draft 2020-12. Schemas are immutable after registration; family + version become logical_key. Per-owner with `_system` fallback for shared built-in shapes.

create_record

Write a validated data entry conforming to a registered schema. Records pin exact schema version and re-validate on content update. Validation errors include every failure with structured envelope.

AWARENESS_HOST

`0.0.0.0`

AWARENESS_OAUTH_JWKS_URI

`{issuer}/.well-known/jwks.json`

AWARENESS_TRANSPORT

`stdio`

AWARENESS_EMBEDDING_DIMENSIONS

`768`

AWARENESS_OAUTH_AUTO_PROVISION

`false`

Variable

Default

POSTGRES_PASSWORD

`awareness-dev`

get_knowledge

Knowledge entries (patterns, context, preferences, notes). Filter by source, tags, entry_type, since/until, created_after/created_before, learned_from. `hint` param re-ranks results by semantic similarity.

set_preference

Set a portable presentation preference (e.g., `alert_verbosity`, `check_frequency`). Upserts by key + scope.

Proprietary

Proprietary

AWARENESS_JWT_ALGORITHM

`HS256`

AWARENESS_OAUTH_PROXY_BAN_DURATION

`3600`

AWARENESS_SESSION_DATABASE_URL

_(none)_

AWARENESS_OLLAMA_DATA

`~/awareness-ollama`

get_stats

Entry counts by type, list of sources, total count. Call before `get_knowledge` to decide whether to filter.

semantic_search

Deprecated alias for `search`. Will be removed in a future release.

remind

Create a todo, reminder, or planned action. Optional `deliver_at` timestamp for time-based surfacing. Intentions have a lifecycle: pending → fired → active → completed.

get_deleted

List all entries in trash with IDs for restore.

AWARENESS_OAUTH_PROXY_RATE_TOKEN

`60`

AWARENESS_SESSION_POOL_MAX

`5`

AWARENESS_OAUTH_PROXY_RATE_AUTHORIZE

`60`

AWARENESS_SESSION_POOL_MIN

`1`

CLOUDFLARED_CREDS

_(required for named tunnel)_

get_intentions

Pending/active intentions, optionally filtered by state, source, or tags.

report_status

Report system status. Called periodically by edge processes. Upserts one entry per source; stale if TTL expires without refresh.

acted_on

Log that you took action because of an entry. Tags inherited from the entry.

AWARENESS_EMBEDDING_PROVIDER

_(none)_

AWARENESS_MOUNT_PATH

_(none)_

AWARENESS_JWT_SECRET

_(required for self-signed)_

AWARENESS_OAUTH_PROXY

`false`

AWARENESS_STATELESS_HTTP

`false`

AWARENESS_PG_DATA

`~/awareness-pg`

get_suppressions

Active alert suppressions with expiry times and escalation settings.

search

Hybrid search — finds entries by meaning (vector) and by exact terms (FTS), fused via Reciprocal Rank Fusion. Combines with tag/source/type/date/language filters. Requires embedding provider for vector branch; FTS works without it.

suppress_alert

Suppress alerts by source/tags/metric. Time-limited with escalation override — critical alerts can break through.

restore_entry

Restore a soft-deleted entry from trash.

Yes

No

get_status

Full status for a specific source including metrics and inventory.

get_activity

Combined read + action feed, chronological.

AWARENESS_DEFAULT_OWNER

_(system username)_

AWARENESS_OAUTH_PROXY_IP_HEADERS

`CF-Connecting-IP,X-Real-IP`

AWARENESS_SESSION_TTL

`1800`

get_tags

All tags in use with usage counts. Use to discover existing tags and prevent drift.

update_intention

Transition an intention state: pending → fired → active → completed/snoozed/cancelled.

backfill_embeddings

Generate embeddings for entries that don't have one yet, and re-embed stale entries whose content changed. Requires embedding provider.

AWARENESS_OAUTH_PROXY_RATE_REGISTER

`30`

AWARENESS_MAX_SESSIONS_PER_OWNER

`10`

AWARENESS_SESSION_NODE_NAME

_(hostname)_

get_alerts

Active alerts, optionally filtered by source. Drill-down from briefing.

get_unread

Entries with zero reads. Cleanup candidates or missed knowledge.

Tool

Description

get_reads

Read history for entries — who read what, when, from which platform.

report_alert

Report or resolve an alert. Captures diagnostics at detection time. Levels: `warning`, `critical`. Types: `threshold`, `structural`, `baseline`.

Provider

Source