Context MCP Server

by alex-feelio.github.alex-feel/mcp-context-serverv2.2.2

An MCP server that provides persistent multimodal context storage for LLM agents.

9Pythonstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active5d ago

Install Context MCP server

claude mcp add context-alex-feel -e POSTGRESQL_CONNECTION_STRING='<postgresql-connection-string>' -e POSTGRESQL_PASSWORD='<postgresql-password>' -e ANTHROPIC_API_KEY='<anthropic-api-key>' -e OPENAI_API_KEY='<openai-api-key>' -e AZURE_OPENAI_API_KEY='<azure-openai-api-key>' -e HUGGINGFACEHUB_API_TOKEN='<huggingfacehub-api-token>' -e VOYAGE_API_KEY='<voyage-api-key>' -e LANGSMITH_API_KEY='<langsmith-api-key>' -e MCP_AUTH_TOKEN='<mcp-auth-token>' -- uvx mcp-context-server

{
  "mcpServers": {
    "context-alex-feel": {
      "command": "uvx",
      "args": [
        "mcp-context-server"
      ],
      "env": {
        "POSTGRESQL_CONNECTION_STRING": "<postgresql-connection-string>",
        "POSTGRESQL_PASSWORD": "<postgresql-password>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "AZURE_OPENAI_API_KEY": "<azure-openai-api-key>",
        "HUGGINGFACEHUB_API_TOKEN": "<huggingfacehub-api-token>",
        "VOYAGE_API_KEY": "<voyage-api-key>",
        "LANGSMITH_API_KEY": "<langsmith-api-key>",
        "MCP_AUTH_TOKEN": "<mcp-auth-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "context-alex-feel": {
      "command": "uvx",
      "args": [
        "mcp-context-server"
      ],
      "env": {
        "POSTGRESQL_CONNECTION_STRING": "<postgresql-connection-string>",
        "POSTGRESQL_PASSWORD": "<postgresql-password>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "AZURE_OPENAI_API_KEY": "<azure-openai-api-key>",
        "HUGGINGFACEHUB_API_TOKEN": "<huggingfacehub-api-token>",
        "VOYAGE_API_KEY": "<voyage-api-key>",
        "LANGSMITH_API_KEY": "<langsmith-api-key>",
        "MCP_AUTH_TOKEN": "<mcp-auth-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "context-alex-feel": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-context-server"
      ],
      "env": {
        "POSTGRESQL_CONNECTION_STRING": "<postgresql-connection-string>",
        "POSTGRESQL_PASSWORD": "<postgresql-password>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "AZURE_OPENAI_API_KEY": "<azure-openai-api-key>",
        "HUGGINGFACEHUB_API_TOKEN": "<huggingfacehub-api-token>",
        "VOYAGE_API_KEY": "<voyage-api-key>",
        "LANGSMITH_API_KEY": "<langsmith-api-key>",
        "MCP_AUTH_TOKEN": "<mcp-auth-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "context-alex-feel": {
      "command": "uvx",
      "args": [
        "mcp-context-server"
      ],
      "env": {
        "POSTGRESQL_CONNECTION_STRING": "<postgresql-connection-string>",
        "POSTGRESQL_PASSWORD": "<postgresql-password>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "AZURE_OPENAI_API_KEY": "<azure-openai-api-key>",
        "HUGGINGFACEHUB_API_TOKEN": "<huggingfacehub-api-token>",
        "VOYAGE_API_KEY": "<voyage-api-key>",
        "LANGSMITH_API_KEY": "<langsmith-api-key>",
        "MCP_AUTH_TOKEN": "<mcp-auth-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
LOG_LEVEL	—	—	Log level
STORAGE_BACKEND	—	—	Storage backend type: sqlite (default) or postgresql
MAX_IMAGE_SIZE_MB	—	—	Maximum individual image size in megabytes
MAX_TOTAL_SIZE_MB	—	—	Maximum total request size in megabytes
DB_PATH	—	—	Custom database file location path
POOL_MAX_READERS	—	—	Maximum number of concurrent read connections in the pool
POOL_MAX_WRITERS	—	—	Maximum number of concurrent write connections in the pool
POOL_CONNECTION_TIMEOUT_S	—	—	Connection timeout in seconds
POOL_IDLE_TIMEOUT_S	—	—	Idle connection timeout in seconds
POOL_HEALTH_CHECK_INTERVAL_S	—	—	Connection health check interval in seconds
RETRY_MAX_RETRIES	—	—	Maximum number of retry attempts for failed operations
RETRY_BASE_DELAY_S	—	—	Base delay in seconds between retry attempts
RETRY_MAX_DELAY_S	—	—	Maximum delay in seconds between retry attempts
RETRY_JITTER	—	—	Enable random jitter in retry delays
RETRY_BACKOFF_FACTOR	—	—	Exponential backoff multiplication factor for retries
SQLITE_FOREIGN_KEYS	—	—	Enable SQLite foreign key constraints
SQLITE_JOURNAL_MODE	—	—	SQLite journal mode (e.g., WAL, DELETE)
SQLITE_SYNCHRONOUS	—	—	SQLite synchronous mode (e.g., NORMAL, FULL, OFF)
SQLITE_TEMP_STORE	—	—	SQLite temporary storage location (e.g., MEMORY, FILE)
SQLITE_MMAP_SIZE	—	—	SQLite memory-mapped I/O size in bytes
SQLITE_CACHE_SIZE	—	—	SQLite cache size (negative value for KB, positive for pages)
SQLITE_PAGE_SIZE	—	—	SQLite page size in bytes
SQLITE_WAL_AUTOCHECKPOINT	—	—	SQLite WAL autocheckpoint threshold in pages
SQLITE_BUSY_TIMEOUT_MS	—	—	SQLite busy timeout in milliseconds
SQLITE_WAL_CHECKPOINT	—	—	SQLite WAL checkpoint mode (e.g., PASSIVE, FULL, RESTART)
SHUTDOWN_TIMEOUT_S	—	—	Server shutdown timeout in seconds
SHUTDOWN_TIMEOUT_TEST_S	—	—	Test mode shutdown timeout in seconds
QUEUE_TIMEOUT_S	—	—	Queue operation timeout in seconds
QUEUE_TIMEOUT_TEST_S	—	—	Test mode queue timeout in seconds
CIRCUIT_BREAKER_FAILURE_THRESHOLD	—	—	Circuit breaker failure threshold before opening
CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S	—	—	Circuit breaker recovery timeout in seconds
CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS	—	—	Maximum calls allowed in circuit breaker half-open state
POSTGRESQL_CONNECTION_STRING	—	yes	Complete PostgreSQL connection string (overrides individual settings if provided)
POSTGRESQL_HOST	—	—	PostgreSQL server host address
POSTGRESQL_PORT	—	—	PostgreSQL server port number
POSTGRESQL_USER	—	—	PostgreSQL database username
POSTGRESQL_PASSWORD	—	yes	PostgreSQL database password
POSTGRESQL_DATABASE	—	—	PostgreSQL database name
POSTGRESQL_POOL_MIN	—	—	PostgreSQL connection pool minimum size
POSTGRESQL_POOL_MAX	—	—	PostgreSQL connection pool maximum size
POSTGRESQL_POOL_TIMEOUT_S	—	—	PostgreSQL connection pool timeout in seconds
POSTGRESQL_COMMAND_TIMEOUT_S	—	—	PostgreSQL command execution timeout in seconds
POSTGRESQL_MIGRATION_TIMEOUT_S	—	—	Timeout in seconds for PostgreSQL migration operations (default: 300)
POSTGRESQL_MAX_INACTIVE_LIFETIME_S	—	—	Close idle PostgreSQL connections after this many seconds (0 to disable, default: 300)
POSTGRESQL_MAX_QUERIES	—	—	Recycle PostgreSQL connections after this many queries (0 to disable, default: 10000)
POSTGRESQL_TCP_KEEPALIVES_IDLE_S	—	—	Seconds of idle time before sending first TCP keepalive probe (0 to disable, default: 15)
POSTGRESQL_TCP_KEEPALIVES_INTERVAL_S	—	—	Seconds between subsequent TCP keepalive probes (0 to disable, default: 5)
POSTGRESQL_TCP_KEEPALIVES_COUNT	—	—	Number of failed TCP keepalive probes before connection is considered dead (0 to disable, default: 3)
POSTGRESQL_STATEMENT_CACHE_SIZE	—	—	asyncpg prepared statement cache size. Set to 0 for external pooler compatibility (PgBouncer transaction mode, Pgpool-II, etc.). Default: 100
POSTGRESQL_MAX_CACHED_STATEMENT_LIFETIME_S	—	—	Maximum lifetime of cached prepared statements in seconds (default: 300). Has no effect when statement_cache_size=0
POSTGRESQL_MAX_CACHEABLE_STATEMENT_SIZE	—	—	Maximum size of statement to cache in bytes (default: 15360). Has no effect when statement_cache_size=0
POSTGRESQL_SSL_MODE	—	—	PostgreSQL SSL mode (disable, allow, prefer, require, verify-ca, verify-full)
POSTGRESQL_SCHEMA	—	—	PostgreSQL schema name for table and index operations (default: public)
ENABLE_SEMANTIC_SEARCH	—	—	Enable semantic search functionality
ENABLE_EMBEDDING_GENERATION	—	—	Enable embedding generation for stored context. Default true - server fails if dependencies not met. Set false to disable embeddings.
OLLAMA_HOST	—	—	Ollama API host URL for embedding generation
OLLAMA_AUTO_PULL	—	—	Automatically pull missing Ollama models on startup (default: true)
OLLAMA_PULL_TIMEOUT_S	—	—	Timeout in seconds for pulling Ollama models (default: 900, range: 30-3600)
EMBEDDING_OLLAMA_TRUNCATE	—	—	Ollama embedding truncation mode: false (default) returns error when context exceeded, true enables silent truncation
EMBEDDING_OLLAMA_NUM_CTX	—	—	Ollama embedding context window size in tokens (default: 4096, range: 512-2097152)
EMBEDDING_MODEL	—	—	Embedding model name for semantic search
EMBEDDING_DIM	—	—	Embedding vector dimensions
EMBEDDING_TIMEOUT_S	—	—	Timeout in seconds for embedding generation API calls
EMBEDDING_RETRY_MAX_ATTEMPTS	—	—	Maximum number of retry attempts for embedding generation
EMBEDDING_RETRY_BASE_DELAY_S	—	—	Base delay in seconds between retry attempts (with exponential backoff)
EMBEDDING_MAX_CONCURRENT	—	—	Maximum concurrent embedding generation operations (default: 3, range: 1-20)
ENABLE_SUMMARY_GENERATION	—	—	Enable summary generation for stored context. Default true - server fails if dependencies not met. Set false to disable summaries.
SUMMARY_PROVIDER	—	—	Summary provider: ollama (default), openai, or anthropic
SUMMARY_MODEL	—	—	Summary generation model name (default: qwen3:0.6b)
SUMMARY_MAX_TOKENS	—	—	Maximum output tokens for summary generation (default: 4000, range: 50-16384). Increase if summaries are truncated by reasoning models
SUMMARY_TIMEOUT_S	—	—	Timeout in seconds for summary generation API calls
SUMMARY_RETRY_MAX_ATTEMPTS	—	—	Maximum number of retry attempts for summary generation
SUMMARY_RETRY_BASE_DELAY_S	—	—	Base delay in seconds between retry attempts (with exponential backoff)
SUMMARY_MAX_CONCURRENT	—	—	Maximum concurrent summary generation operations (default: 3, range: 1-20)
SUMMARY_PROMPT	—	—	Custom summarization prompt. Overrides the built-in default. Used as system message for the LLM.
SUMMARY_MIN_CONTENT_LENGTH	—	—	Minimum text content length in characters to trigger summary generation (default: 500, range: 0-10000). Set to 0 to always generate.
SUMMARY_OLLAMA_NUM_CTX	—	—	Ollama summary context window size in tokens (default: 32768, range: 512-2097152)
SUMMARY_OLLAMA_TRUNCATE	—	—	Ollama summary truncation mode: false (default) returns error when context exceeded, true enables silent truncation
SUMMARY_OPENAI_REASONING_EFFORT	—	—	Reasoning effort level for OpenAI reasoning models (default: low). Valid values vary by generation: gpt-5: low, medium, high; gpt-5.1+: none, low, medium, high, xhigh. Default low is universally valid across all generations
SUMMARY_ANTHROPIC_EFFORT	—	—	Effort level for Anthropic Claude models (default: none). Valid values: max, high, medium, low. Controls inference effort (adaptive thinking)
ANTHROPIC_API_KEY	—	yes	Anthropic API key for summary generation
ENABLE_FTS	—	—	Enable full-text search functionality
FTS_LANGUAGE	—	—	Language for FTS stemming (e.g., english, german, french)
FTS_RERANK_WINDOW_SIZE	—	—	Characters of context around each FTS match for reranking passage extraction (default: 750)
FTS_RERANK_GAP_MERGE	—	—	Merge FTS match regions within this character distance (default: 100)
ENABLE_HYBRID_SEARCH	—	—	Enable hybrid search combining FTS and semantic search with RRF fusion
HYBRID_RRF_K	—	—	RRF smoothing constant for hybrid search (default 60)
HYBRID_RRF_OVERFETCH	—	—	Multiplier for over-fetching results before RRF fusion (default: 2)
HYBRID_FTS_OR_THRESHOLD	—	—	Minimum significant query terms to switch hybrid FTS from AND to OR logic (default: 4)
SEARCH_DEFAULT_SORT_BY	—	—	Default sort order for search results: relevance (only 'relevance' supported in current version)
SEARCH_TRUNCATION_LENGTH	—	—	Maximum character length for truncated text_content in search results (default: 300, range: 50-1000)
ENABLE_CHUNKING	—	—	Enable text chunking for embedding generation (default: true)
CHUNK_SIZE	—	—	Target chunk size in characters (default: 1500)
CHUNK_OVERLAP	—	—	Overlap between chunks in characters (default: 150)
CHUNK_AGGREGATION	—	—	Chunk score aggregation method: max (only 'max' supported in current version)
CHUNK_DEDUP_OVERFETCH	—	—	Multiplier for over-fetching chunks before deduplication (default: 5)
ENABLE_RERANKING	—	—	Enable cross-encoder reranking of search results (default: true)
RERANKING_PROVIDER	—	—	Reranking provider (default: flashrank)
RERANKING_MODEL	—	—	Reranking model name (default: ms-marco-MiniLM-L-12-v2)
RERANKING_MAX_LENGTH	—	—	Maximum input length for reranking in tokens (default: 512)
RERANKING_OVERFETCH	—	—	Multiplier for over-fetching results before reranking (default: 4)
RERANKING_CACHE_DIR	—	—	Directory for caching reranking models
RERANKING_CHARS_PER_TOKEN	—	—	Estimated characters per token for passage size validation (default: 4.0, range: 2.0-8.0)
RERANKING_INTRA_OP_THREADS	—	—	ONNX Runtime intra-operation parallelism threads for reranking (default: 0 = auto-detect)
RERANKING_CPU_MEM_ARENA	—	—	Enable ONNX Runtime CPU memory arena for reranking (default: false)
RERANKING_BATCH_SIZE	—	—	Maximum passages per ONNX Runtime inference batch during reranking (default: 32)
EMBEDDING_PROVIDER	—	—	Embedding provider: ollama (default), openai, azure, huggingface, or voyage
OPENAI_API_KEY	—	yes	OpenAI API key for OpenAI embedding provider
OPENAI_API_BASE	—	—	Custom base URL for OpenAI-compatible APIs
OPENAI_ORGANIZATION	—	—	OpenAI organization ID
AZURE_OPENAI_API_KEY	—	yes	Azure OpenAI API key
AZURE_OPENAI_ENDPOINT	—	—	Azure OpenAI endpoint URL
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME	—	—	Azure OpenAI embedding deployment name
AZURE_OPENAI_API_VERSION	—	—	Azure OpenAI API version (default: 2024-02-01)
HUGGINGFACEHUB_API_TOKEN	—	yes	HuggingFace Hub API token for HuggingFace embedding provider
VOYAGE_API_KEY	—	yes	Voyage AI API key for Voyage embedding provider
VOYAGE_TRUNCATION	—	—	Voyage AI truncation mode: false (default) returns error when context exceeded, true enables silent truncation
VOYAGE_BATCH_SIZE	—	—	Voyage AI batch size for embedding requests
LANGSMITH_TRACING	—	—	Enable LangSmith tracing
LANGSMITH_API_KEY	—	yes	LangSmith API key
LANGSMITH_PROJECT	—	—	LangSmith project name
LANGSMITH_ENDPOINT	—	—	LangSmith API endpoint URL
METADATA_INDEXED_FIELDS	—	—	Comma-separated list of metadata fields to index (field:type format)
METADATA_INDEX_SYNC_MODE	—	—	Index sync mode: strict (fail), auto (sync), warn (log), additive (default, add missing only)
MCP_TRANSPORT	—	—	Transport mode: stdio for local, http for Docker/remote
FASTMCP_HOST	—	—	HTTP bind address (use 0.0.0.0 for Docker)
FASTMCP_PORT	—	—	HTTP port number
FASTMCP_STATELESS_HTTP	—	—	Enable stateless HTTP mode for horizontal scaling. Enabled by default as the server has no stateful MCP features. Set to false only if you need server-side MCP session tracking.
DISABLED_TOOLS	—	—	Comma-separated list of tools to disable (e.g., delete_context,update_context)
MCP_AUTH_TOKEN	—	yes	Bearer token for HTTP authentication (required when using SimpleTokenVerifier)
MCP_AUTH_CLIENT_ID	—	—	Client ID to assign to authenticated requests
MCP_AUTH_PROVIDER	—	—	Authentication provider: none (default), simple_token
MCP_SERVER_INSTRUCTIONS	—	—	Custom server instructions text. Overrides built-in default. Set to empty string to disable.

Freshness

Active — last maintenance signal 5d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-04 · 5d ago · GitHub
Latest release
2026-03-28 · 7mo ago · GitHub · v2.2.2
Package published
no data · npm/PyPI
Registry entry updated
2026-03-28 · 7mo ago · official registry · v2.2.2

FAQ

›How do I install the Context MCP server in Claude Code?

Run: claude mcp add context-alex-feel -e POSTGRESQL_CONNECTION_STRING='<postgresql-connection-string>' -e POSTGRESQL_PASSWORD='<postgresql-password>' -e ANTHROPIC_API_KEY='<anthropic-api-key>' -e OPENAI_API_KEY='<openai-api-key>' -e AZURE_OPENAI_API_KEY='<azure-openai-api-key>' -e HUGGINGFACEHUB_API_TOKEN='<huggingfacehub-api-token>' -e VOYAGE_API_KEY='<voyage-api-key>' -e LANGSMITH_API_KEY='<langsmith-api-key>' -e MCP_AUTH_TOKEN='<mcp-auth-token>' -- uvx mcp-context-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Context require an API key?

Yes. It expects POSTGRESQL_CONNECTION_STRING, POSTGRESQL_PASSWORD, ANTHROPIC_API_KEY, OPENAI_API_KEY, AZURE_OPENAI_API_KEY, HUGGINGFACEHUB_API_TOKEN, VOYAGE_API_KEY, LANGSMITH_API_KEY, MCP_AUTH_TOKEN, of which 9 are secrets.

›Can I use Context as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Context in the official MCP registry?

Yes, as io.github.alex-feel/mcp-context-server.