mcp-context-server

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

communityinfra

Package Details

mcp-context-server

0.17.0•https://pypi.org/project/mcp-context-server

Transportstdio

Environment Variables

LOG_LEVEL(str)

Log level

STORAGE_BACKEND(str)

Storage backend type: sqlite (default) or postgresql

MAX_IMAGE_SIZE_MB(num)

Maximum individual image size in megabytes

MAX_TOTAL_SIZE_MB(num)

Maximum total request size in megabytes

DB_PATH(str)

Custom database file location path

POOL_MAX_READERS(num)

Maximum number of concurrent read connections in the pool

POOL_MAX_WRITERS(num)

Maximum number of concurrent write connections in the pool

POOL_CONNECTION_TIMEOUT_S(num)

Connection timeout in seconds

POOL_IDLE_TIMEOUT_S(num)

Idle connection timeout in seconds

POOL_HEALTH_CHECK_INTERVAL_S(num)

Connection health check interval in seconds

RETRY_MAX_RETRIES(num)

Maximum number of retry attempts for failed operations

RETRY_BASE_DELAY_S(num)

Base delay in seconds between retry attempts

RETRY_MAX_DELAY_S(num)

Maximum delay in seconds between retry attempts

RETRY_JITTER(bool)

Enable random jitter in retry delays

RETRY_BACKOFF_FACTOR(num)

Exponential backoff multiplication factor for retries

SQLITE_FOREIGN_KEYS(bool)

Enable SQLite foreign key constraints

SQLITE_JOURNAL_MODE(str)

SQLite journal mode (e.g., WAL, DELETE)

SQLITE_SYNCHRONOUS(str)

SQLite synchronous mode (e.g., NORMAL, FULL, OFF)

SQLITE_TEMP_STORE(str)

SQLite temporary storage location (e.g., MEMORY, FILE)

SQLITE_MMAP_SIZE(num)

SQLite memory-mapped I/O size in bytes

SQLITE_CACHE_SIZE(num)

SQLite cache size (negative value for KB, positive for pages)

SQLITE_PAGE_SIZE(num)

SQLite page size in bytes

SQLITE_WAL_AUTOCHECKPOINT(num)

SQLite WAL autocheckpoint threshold in pages

SQLITE_BUSY_TIMEOUT_MS(num)

SQLite busy timeout in milliseconds

SQLITE_WAL_CHECKPOINT(str)

SQLite WAL checkpoint mode (e.g., PASSIVE, FULL, RESTART)

SHUTDOWN_TIMEOUT_S(num)

Server shutdown timeout in seconds

SHUTDOWN_TIMEOUT_TEST_S(num)

Test mode shutdown timeout in seconds

QUEUE_TIMEOUT_S(num)

Queue operation timeout in seconds

QUEUE_TIMEOUT_TEST_S(num)

Test mode queue timeout in seconds

CIRCUIT_BREAKER_FAILURE_THRESHOLD(num)

Circuit breaker failure threshold before opening

CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S(num)

Circuit breaker recovery timeout in seconds

CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS(num)

Maximum calls allowed in circuit breaker half-open state

POSTGRESQL_CONNECTION_STRING(str)

Secret

Complete PostgreSQL connection string (overrides individual settings if provided)

POSTGRESQL_HOST(str)

PostgreSQL server host address

POSTGRESQL_PORT(num)

PostgreSQL server port number

POSTGRESQL_USER(str)

PostgreSQL database username

POSTGRESQL_PASSWORD(str)

Secret

PostgreSQL database password

POSTGRESQL_DATABASE(str)

PostgreSQL database name

POSTGRESQL_POOL_MIN(num)

PostgreSQL connection pool minimum size

POSTGRESQL_POOL_MAX(num)

PostgreSQL connection pool maximum size

POSTGRESQL_POOL_TIMEOUT_S(num)

PostgreSQL connection pool timeout in seconds

POSTGRESQL_COMMAND_TIMEOUT_S(num)

PostgreSQL command execution timeout in seconds

POSTGRESQL_SSL_MODE(str)

PostgreSQL SSL mode (disable, allow, prefer, require, verify-ca, verify-full)

POSTGRESQL_SCHEMA(str)

PostgreSQL schema name for table and index operations (default: public)

ENABLE_SEMANTIC_SEARCH(bool)

Enable semantic search functionality

OLLAMA_HOST(str)

Ollama API host URL for embedding generation

EMBEDDING_MODEL(str)

Embedding model name for semantic search

EMBEDDING_DIM(num)

Embedding vector dimensions

EMBEDDING_TIMEOUT_S(num)

Timeout in seconds for embedding generation API calls

EMBEDDING_RETRY_MAX_ATTEMPTS(num)

Maximum number of retry attempts for embedding generation

EMBEDDING_RETRY_BASE_DELAY_S(num)

Base delay in seconds between retry attempts (with exponential backoff)

ENABLE_FTS(bool)

Enable full-text search functionality

FTS_LANGUAGE(str)

Language for FTS stemming (e.g., english, german, french)

ENABLE_HYBRID_SEARCH(bool)

Enable hybrid search combining FTS and semantic search with RRF fusion

HYBRID_RRF_K(num)

RRF smoothing constant for hybrid search (default 60)

EMBEDDING_PROVIDER(str)

Embedding provider: ollama (default), openai, azure, huggingface, or voyage

OPENAI_API_KEY(str)

Secret

OpenAI API key for OpenAI embedding provider

OPENAI_API_BASE(str)

Custom base URL for OpenAI-compatible APIs

OPENAI_ORGANIZATION(str)

OpenAI organization ID

AZURE_OPENAI_API_KEY(str)

Secret

Azure OpenAI API key

AZURE_OPENAI_ENDPOINT(str)

Azure OpenAI endpoint URL

AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME(str)

Azure OpenAI embedding deployment name

AZURE_OPENAI_API_VERSION(str)

Azure OpenAI API version (default: 2024-02-01)

HUGGINGFACEHUB_API_TOKEN(str)

Secret

HuggingFace Hub API token for HuggingFace embedding provider

VOYAGE_API_KEY(str)

Secret

Voyage AI API key for Voyage embedding provider

VOYAGE_TRUNCATION(bool)

Voyage AI truncation mode (true/false)

VOYAGE_BATCH_SIZE(num)

Voyage AI batch size for embedding requests

LANGSMITH_TRACING(bool)

Enable LangSmith tracing

LANGSMITH_API_KEY(str)

Secret

LangSmith API key

LANGSMITH_PROJECT(str)

LangSmith project name

LANGSMITH_ENDPOINT(str)

LangSmith API endpoint URL

METADATA_INDEXED_FIELDS(str)

Comma-separated list of metadata fields to index (field:type format)

METADATA_INDEX_SYNC_MODE(str)

Index sync mode: strict (fail), auto (sync), warn (log), additive (default, add missing only)

MCP_TRANSPORT(str)

Transport mode: stdio for local, http for Docker/remote

FASTMCP_HOST(str)

HTTP bind address (use 0.0.0.0 for Docker)

FASTMCP_PORT(num)

HTTP port number

DISABLED_TOOLS(str)

Comma-separated list of tools to disable (e.g., delete_context,update_context)

MCP_AUTH_TOKEN(str)

Secret

Bearer token for HTTP authentication (required when using SimpleTokenVerifier)

MCP_AUTH_CLIENT_ID(str)

Client ID to assign to authenticated requests

FASTMCP_SERVER_AUTH(str)

Authentication provider class path (e.g., app.auth.simple_token.SimpleTokenVerifier)

FASTMCP_SERVER_AUTH_GOOGLE_CLIENT_ID(str)

Google OAuth Client ID (required when using GoogleProvider)

FASTMCP_SERVER_AUTH_GOOGLE_CLIENT_SECRET(str)

Secret

Google OAuth Client Secret (required when using GoogleProvider)

FASTMCP_SERVER_AUTH_GOOGLE_BASE_URL(str)

Server base URL for OAuth callbacks (required when using GoogleProvider)

FASTMCP_SERVER_AUTH_GOOGLE_REQUIRED_SCOPES(str)

Required OAuth scopes (comma-separated, e.g., openid,email)

FASTMCP_SERVER_AUTH_AZURE_CLIENT_ID(str)

Azure OAuth Client ID (required when using AzureProvider)

FASTMCP_SERVER_AUTH_AZURE_CLIENT_SECRET(str)

Secret

Azure OAuth Client Secret (required when using AzureProvider)

FASTMCP_SERVER_AUTH_AZURE_TENANT_ID(str)

Azure Tenant ID - use specific GUID for org-only access, 'organizations' for multi-tenant, or 'consumers' for personal accounts

FASTMCP_SERVER_AUTH_AZURE_BASE_URL(str)

Server base URL for OAuth callbacks (required when using AzureProvider)

FASTMCP_SERVER_AUTH_AZURE_REQUIRED_SCOPES(str)

Required OAuth scopes for Azure (comma-separated, e.g., read,write)

ghcr.io/alex-feel/mcp-context-server:0.17.0

https://github.com/alex-feel/mcp-context-server/pkgs/container/mcp-context-server

TransportStreamable HTTP

Runtimedocker

Environment Variables

LOG_LEVEL(str)

Log level

STORAGE_BACKEND(str)

Storage backend type: sqlite (default) or postgresql

MAX_IMAGE_SIZE_MB(num)

Maximum individual image size in megabytes

MAX_TOTAL_SIZE_MB(num)

Maximum total request size in megabytes

DB_PATH(str)

Custom database file location path

POOL_MAX_READERS(num)

Maximum number of concurrent read connections in the pool

POOL_MAX_WRITERS(num)

Maximum number of concurrent write connections in the pool

POOL_CONNECTION_TIMEOUT_S(num)

Connection timeout in seconds

POOL_IDLE_TIMEOUT_S(num)

Idle connection timeout in seconds

POOL_HEALTH_CHECK_INTERVAL_S(num)

Connection health check interval in seconds

RETRY_MAX_RETRIES(num)

Maximum number of retry attempts for failed operations

RETRY_BASE_DELAY_S(num)

Base delay in seconds between retry attempts

RETRY_MAX_DELAY_S(num)

Maximum delay in seconds between retry attempts

RETRY_JITTER(bool)

Enable random jitter in retry delays

RETRY_BACKOFF_FACTOR(num)

Exponential backoff multiplication factor for retries

SQLITE_FOREIGN_KEYS(bool)

Enable SQLite foreign key constraints

SQLITE_JOURNAL_MODE(str)

SQLite journal mode (e.g., WAL, DELETE)

SQLITE_SYNCHRONOUS(str)

SQLite synchronous mode (e.g., NORMAL, FULL, OFF)

SQLITE_TEMP_STORE(str)

SQLite temporary storage location (e.g., MEMORY, FILE)

SQLITE_MMAP_SIZE(num)

SQLite memory-mapped I/O size in bytes

SQLITE_CACHE_SIZE(num)

SQLite cache size (negative value for KB, positive for pages)

SQLITE_PAGE_SIZE(num)

SQLite page size in bytes

SQLITE_WAL_AUTOCHECKPOINT(num)

SQLite WAL autocheckpoint threshold in pages

SQLITE_BUSY_TIMEOUT_MS(num)

SQLite busy timeout in milliseconds

SQLITE_WAL_CHECKPOINT(str)

SQLite WAL checkpoint mode (e.g., PASSIVE, FULL, RESTART)

SHUTDOWN_TIMEOUT_S(num)

Server shutdown timeout in seconds

SHUTDOWN_TIMEOUT_TEST_S(num)

Test mode shutdown timeout in seconds

QUEUE_TIMEOUT_S(num)

Queue operation timeout in seconds

QUEUE_TIMEOUT_TEST_S(num)

Test mode queue timeout in seconds

CIRCUIT_BREAKER_FAILURE_THRESHOLD(num)

Circuit breaker failure threshold before opening

CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S(num)

Circuit breaker recovery timeout in seconds

CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS(num)

Maximum calls allowed in circuit breaker half-open state

POSTGRESQL_CONNECTION_STRING(str)

Secret

Complete PostgreSQL connection string (overrides individual settings if provided)

POSTGRESQL_HOST(str)

PostgreSQL server host address

POSTGRESQL_PORT(num)

PostgreSQL server port number

POSTGRESQL_USER(str)

PostgreSQL database username

POSTGRESQL_PASSWORD(str)

Secret

PostgreSQL database password

POSTGRESQL_DATABASE(str)

PostgreSQL database name

POSTGRESQL_POOL_MIN(num)

PostgreSQL connection pool minimum size

POSTGRESQL_POOL_MAX(num)

PostgreSQL connection pool maximum size

POSTGRESQL_POOL_TIMEOUT_S(num)

PostgreSQL connection pool timeout in seconds

POSTGRESQL_COMMAND_TIMEOUT_S(num)

PostgreSQL command execution timeout in seconds

POSTGRESQL_SSL_MODE(str)

PostgreSQL SSL mode (disable, allow, prefer, require, verify-ca, verify-full)

POSTGRESQL_SCHEMA(str)

PostgreSQL schema name for table and index operations (default: public)

ENABLE_SEMANTIC_SEARCH(bool)

Enable semantic search functionality

OLLAMA_HOST(str)

Ollama API host URL for embedding generation

EMBEDDING_MODEL(str)

Embedding model name for semantic search

EMBEDDING_DIM(num)

Embedding vector dimensions

EMBEDDING_TIMEOUT_S(num)

Timeout in seconds for embedding generation API calls

EMBEDDING_RETRY_MAX_ATTEMPTS(num)

Maximum number of retry attempts for embedding generation

EMBEDDING_RETRY_BASE_DELAY_S(num)

Base delay in seconds between retry attempts (with exponential backoff)

ENABLE_FTS(bool)

Enable full-text search functionality

FTS_LANGUAGE(str)

Language for FTS stemming (e.g., english, german, french)

ENABLE_HYBRID_SEARCH(bool)

Enable hybrid search combining FTS and semantic search with RRF fusion

HYBRID_RRF_K(num)

RRF smoothing constant for hybrid search (default 60)

EMBEDDING_PROVIDER(str)

Embedding provider: ollama (default), openai, azure, huggingface, or voyage

OPENAI_API_KEY(str)

Secret

OpenAI API key for OpenAI embedding provider

OPENAI_API_BASE(str)

Custom base URL for OpenAI-compatible APIs

OPENAI_ORGANIZATION(str)

OpenAI organization ID

AZURE_OPENAI_API_KEY(str)

Secret

Azure OpenAI API key

AZURE_OPENAI_ENDPOINT(str)

Azure OpenAI endpoint URL

AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME(str)

Azure OpenAI embedding deployment name

AZURE_OPENAI_API_VERSION(str)

Azure OpenAI API version (default: 2024-02-01)

HUGGINGFACEHUB_API_TOKEN(str)

Secret

HuggingFace Hub API token for HuggingFace embedding provider

VOYAGE_API_KEY(str)

Secret

Voyage AI API key for Voyage embedding provider

VOYAGE_TRUNCATION(bool)

Voyage AI truncation mode (true/false)

VOYAGE_BATCH_SIZE(num)

Voyage AI batch size for embedding requests

LANGSMITH_TRACING(bool)

Enable LangSmith tracing

LANGSMITH_API_KEY(str)

Secret

LangSmith API key

LANGSMITH_PROJECT(str)

LangSmith project name

LANGSMITH_ENDPOINT(str)

LangSmith API endpoint URL

METADATA_INDEXED_FIELDS(str)

Comma-separated list of metadata fields to index (field:type format)

METADATA_INDEX_SYNC_MODE(str)

Index sync mode: strict (fail), auto (sync), warn (log), additive (default, add missing only)

MCP_TRANSPORT(str)

Transport mode: stdio for local, http for Docker/remote

FASTMCP_HOST(str)

HTTP bind address (use 0.0.0.0 for Docker)

FASTMCP_PORT(num)

HTTP port number

DISABLED_TOOLS(str)

Comma-separated list of tools to disable (e.g., delete_context,update_context)

MCP_AUTH_TOKEN(str)

Secret

Bearer token for HTTP authentication (required when using SimpleTokenVerifier)

MCP_AUTH_CLIENT_ID(str)

Client ID to assign to authenticated requests

FASTMCP_SERVER_AUTH(str)

Authentication provider class path (e.g., app.auth.simple_token.SimpleTokenVerifier)

FASTMCP_SERVER_AUTH_GOOGLE_CLIENT_ID(str)

Google OAuth Client ID (required when using GoogleProvider)

FASTMCP_SERVER_AUTH_GOOGLE_CLIENT_SECRET(str)

Secret

Google OAuth Client Secret (required when using GoogleProvider)

FASTMCP_SERVER_AUTH_GOOGLE_BASE_URL(str)

Server base URL for OAuth callbacks (required when using GoogleProvider)

FASTMCP_SERVER_AUTH_GOOGLE_REQUIRED_SCOPES(str)

Required OAuth scopes (comma-separated, e.g., openid,email)

FASTMCP_SERVER_AUTH_AZURE_CLIENT_ID(str)

Azure OAuth Client ID (required when using AzureProvider)

FASTMCP_SERVER_AUTH_AZURE_CLIENT_SECRET(str)

Secret

Azure OAuth Client Secret (required when using AzureProvider)

FASTMCP_SERVER_AUTH_AZURE_TENANT_ID(str)

Azure Tenant ID - use specific GUID for org-only access, 'organizations' for multi-tenant, or 'consumers' for personal accounts

FASTMCP_SERVER_AUTH_AZURE_BASE_URL(str)

Server base URL for OAuth callbacks (required when using AzureProvider)

FASTMCP_SERVER_AUTH_AZURE_REQUIRED_SCOPES(str)

Required OAuth scopes for Azure (comma-separated, e.g., read,write)