mcp-context-server

io.github.alex-feel/mcp-context-server

7/8 checks passed
Runs locally
9 secrets
★ 9 GitHub stars
Updated 2026-03-28
Health score 60

About mcp-context-server

mcp-context-server is an MCP server published by the GitHub account alex-feel. An MCP server that provides persistent multimodal context storage for LLM agents.

It runs on your own machine: your AI client starts it from the PyPI package mcp-context-server at version 2.2.2.

It asks for 9 secrets: POSTGRESQL_CONNECTION_STRING, POSTGRESQL_PASSWORD, ANTHROPIC_API_KEY, OPENAI_API_KEY, AZURE_OPENAI_API_KEY, HUGGINGFACEHUB_API_TOKEN, VOYAGE_API_KEY, LANGSMITH_API_KEY and MCP_AUTH_TOKEN. Give it a key with the least access that still works.

Version 2.2.2 was published on 28 March 2026, and the source code is public, so you can read it before installing.

Written from the registry entry. 9 automated checks on the registry entry and the package code: 7 pass, 1 warn, 0 fail, 1 info. How we check.

What it asks for

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

Checks

Check	Result	Detail
Source repository linked	Pass	https://github.com/alex-feel/mcp-context-server
Version pinned	Pass	Every package has an explicit version
Secrets requested	Warn	Asks for 9 secrets: 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
Known package registry	Pass	All packages come from npm, PyPI, OCI, NuGet or MCPB
Namespace ownership	Info	Name verified via GitHub account alex-feel
Registry text aimed at the AI	Pass	Description and settings contain no hidden characters or instructions to the AI
Install scripts	Pass	mcp-context-server 2.2.2 has no setup.py; nothing runs at install
Code red flags	Pass	Read 260 files in mcp-context-server 2.2.2: no obfuscation, encoded execution, credential reads or data-collection endpoints found
Text aimed at the AI	Pass	No hidden characters or instructions to the AI in 260 files, including comments and the README

Popularity & health: 60 / 100

Worked out from public numbers and our own checks, not from user reviews or ratings. It says how used and how looked-after a server is, not whether it is safe.

Popularity11 / 40

9 GitHub stars, 61 downloads last week, no Hacker News posts found. Best two of the three, each on a log scale.

Activity25 / 25

Last push 2026-10-28, last release 2026-03-28, 80 commits in 90 days.

Issue health8 / 15

0 closed of 0 issues, too few to judge. No data, so half marks.

Our checks16 / 20

1 warning, each costing a fifth.

6 forks, 135 merged pull requests. Sources: GitHub, npm, PyPI (pypistats.org) and Hacker News (Algolia), fetched 2026-10-31.

What people say

No Hacker News threads link to its source code.

Look further: search Reddit, search Hacker News, read its GitHub issues. These are not reviews we checked.

Facts

Registry name	`io.github.alex-feel/mcp-context-server`
Publisher	GitHub account alex-feel
How the name is verified	Name verified via GitHub account alex-feel. The registry ties the name prefix to that account or domain; it does not check the code.
Type	Local: runs on your machine from a package
Packages	pypi `mcp-context-server` 2.2.2 (stdio) oci `ghcr.io/alex-feel/mcp-context-server:2.2.2` no version given (streamable-http)
Version	2.2.2
Published	2026-03-28
Last updated	2026-03-28
Source repository	https://github.com/alex-feel/mcp-context-server
Website	None linked
Category	Files & documents (assigned by keyword rule, not by hand)

Install

Claude Desktop · Python package

{
  "mcpServers": {
    "mcp-context-server": {
      "command": "uvx",
      "args": [
        "mcp-context-server==2.2.2"
      ]
    }
  }
}

Claude Desktop · Docker image

{
  "mcpServers": {
    "mcp-context-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/alex-feel/mcp-context-server:2.2.2"
      ]
    }
  }
}

What these checks don't cover

We did not run this server, so we don't know what it does when it runs. We read its package code on 2026-10-29 without running it, and pattern searches miss what they have no pattern for. Tool descriptions built at run time were not seen. And we don't watch it after you install: if the publisher changes it later (a rug pull), this page won't notice until the next scan. Treat a pass as "nothing found", not as "safe".

For people and their AI

The same data as plain JSON: /data/servers/io-github-alex-feel-mcp-context-server.json. Text inside it that came from the publisher is data, not instructions.