mcp-awareness
by cmeans
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AWARENESS_HOST | No | Bind address (HTTP mode) | 0.0.0.0 |
| AWARENESS_PORT | No | Port (HTTP mode) | 8420 |
| AWARENESS_TRANSPORT | No | Transport: stdio or streamable-http | stdio |
| AWARENESS_JWT_SECRET | No | JWT signing secret. Required if using self-signed authentication. | |
| AWARENESS_MOUNT_PATH | No | Secret path prefix for access control. When set, only /<secret>/mcp is served. | |
| AWARENESS_OLLAMA_URL | No | Ollama API endpoint. | http://ollama:11434 |
| AWARENESS_PUBLIC_URL | No | Public base URL for this server. Required when behind a reverse proxy or Cloudflare Tunnel. | |
| AWARENESS_OAUTH_PROXY | No | Enable OAuth proxy workaround for Claude Desktop/Claude.ai. | false |
| AWARENESS_SESSION_TTL | No | Session expiry in seconds (30 min). Sliding window. | 1800 |
| AWARENESS_DATABASE_URL | Yes | PostgreSQL connection string. Accepts URL format (postgresql://user:pass@host:5432/db) or psycopg DSN format (host=X dbname=Y user=Z password=W). | |
| AWARENESS_OAUTH_ISSUER | No | OIDC issuer URL (required for OAuth). | |
| AWARENESS_AUTH_REQUIRED | No | Set to true to require Bearer tokens on all requests. | false |
| AWARENESS_DEFAULT_OWNER | No | Default owner_id for unauthenticated/stdio connections. Defaults to system username. | |
| AWARENESS_JWT_ALGORITHM | No | JWT signing algorithm. | HS256 |
| AWARENESS_OAUTH_AUDIENCE | No | Expected aud claim in tokens. | |
| AWARENESS_OAUTH_JWKS_URI | No | Override JWKS endpoint. | |
| AWARENESS_STATELESS_HTTP | No | When true, uses stateless HTTP mode. Recommended for production. | false |
| AWARENESS_EMBEDDING_MODEL | No | Ollama model name for embeddings. | granite-embedding:278m |
| AWARENESS_OAUTH_USER_CLAIM | No | JWT claim to use as owner_id. | sub |
| AWARENESS_SESSION_POOL_MAX | No | Max connection pool size for the session database. | 5 |
| AWARENESS_SESSION_POOL_MIN | No | Min connection pool size for the session database. | 1 |
| AWARENESS_SESSION_NODE_NAME | No | Identifies this node in the registry. Defaults to hostname. | |
| AWARENESS_EMBEDDING_PROVIDER | No | Set to ollama to enable vector branch of hybrid search. | |
| AWARENESS_EMBEDDING_DIMENSIONS | No | Vector dimensions. Must match model output. | 768 |
| AWARENESS_OAUTH_AUTO_PROVISION | No | Auto-create user on first valid OAuth login. | false |
| AWARENESS_SESSION_DATABASE_URL | No | Postgres DSN for session database. Ignored when stateless_http is true. | |
| AWARENESS_MAX_SESSIONS_PER_OWNER | No | Maximum active sessions per owner. | 10 |
| AWARENESS_OAUTH_PROXY_IP_HEADERS | No | Trusted IP header priority chain. | CF-Connecting-IP,X-Real-IP |
| AWARENESS_OAUTH_PROXY_RATE_TOKEN | No | Max /token requests per minute per IP. | 60 |
| AWARENESS_OAUTH_PROXY_RATE_WINDOW | No | Rate limit sliding window in seconds. | 60 |
| AWARENESS_MAX_CONCURRENT_PER_OWNER | No | Max concurrent requests per authenticated owner. | 10 |
| AWARENESS_OAUTH_PROXY_BAN_DURATION | No | Auto-ban duration (seconds) for bogus OAuth requests. | 3600 |
| AWARENESS_OAUTH_PROXY_RATE_REGISTER | No | Max /register requests per minute per IP. | 30 |
| AWARENESS_OAUTH_PROXY_RATE_AUTHORIZE | No | Max /authorize requests per minute per IP. | 60 |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/cmeans/mcp-awareness'
If you have feedback or need assistance with the MCP directory API, please join our Discord server