Back to Home
alex-feel icon

mcp-context-server

Verified Safe

by alex-feel

Overview

A high-performance Model Context Protocol (MCP) server providing persistent multimodal context storage for LLM agents, enabling seamless context sharing across multiple agents working on the same task through thread-based scoping.

Installation

Run Command
uvx --python 3.12 mcp-context-server

Environment Variables

  • OPENAI_API_KEY
  • AZURE_OPENAI_API_KEY
  • AZURE_OPENAI_ENDPOINT
  • AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME
  • HUGGINGFACEHUB_API_TOKEN
  • VOYAGE_API_KEY
  • MCP_AUTH_TOKEN
  • POSTGRESQL_PASSWORD
  • POSTGRESQL_CONNECTION_STRING
  • LANGSMITH_API_KEY
  • LOG_LEVEL
  • STORAGE_BACKEND
  • DB_PATH
  • MAX_IMAGE_SIZE_MB
  • MAX_TOTAL_SIZE_MB
  • ENABLE_FTS
  • FTS_LANGUAGE
  • ENABLE_HYBRID_SEARCH
  • HYBRID_RRF_K
  • ENABLE_CHUNKING
  • CHUNK_SIZE
  • CHUNK_OVERLAP
  • CHUNK_AGGREGATION
  • ENABLE_RERANKING
  • RERANKING_PROVIDER
  • RERANKING_MODEL
  • RERANKING_OVERFETCH
  • RERANKING_CACHE_DIR
  • RERANKING_CHARS_PER_TOKEN
  • ENABLE_SEMANTIC_SEARCH
  • EMBEDDING_PROVIDER
  • EMBEDDING_MODEL
  • EMBEDDING_DIM
  • EMBEDDING_TIMEOUT_S
  • EMBEDDING_RETRY_MAX_ATTEMPTS
  • EMBEDDING_RETRY_BASE_DELAY_S
  • OLLAMA_HOST
  • OLLAMA_NUM_CTX
  • OLLAMA_TRUNCATE
  • OPENAI_API_BASE
  • OPENAI_ORGANIZATION
  • AZURE_OPENAI_API_VERSION
  • VOYAGE_TRUNCATION
  • VOYAGE_BATCH_SIZE
  • LANGSMITH_TRACING
  • LANGSMITH_ENDPOINT
  • LANGSMITH_PROJECT
  • METADATA_INDEXED_FIELDS
  • METADATA_INDEX_SYNC_MODE
  • POSTGRESQL_HOST
  • POSTGRESQL_PORT
  • POSTGRESQL_USER
  • POSTGRESQL_DATABASE
  • POSTGRESQL_SSL_MODE
  • POSTGRESQL_SCHEMA
  • POSTGRESQL_POOL_MIN
  • POSTGRESQL_POOL_MAX
  • POSTGRESQL_POOL_TIMEOUT_S
  • POSTGRESQL_COMMAND_TIMEOUT_S
  • POSTGRESQL_MAX_INACTIVE_LIFETIME_S
  • POSTGRESQL_MAX_QUERIES
  • POSTGRESQL_STATEMENT_CACHE_SIZE
  • POSTGRESQL_MAX_CACHED_STATEMENT_LIFETIME_S
  • POSTGRESQL_MAX_CACHEABLE_STATEMENT_SIZE
  • SEARCH_DEFAULT_SORT_BY
  • FASTMCP_HOST
  • FASTMCP_PORT
  • MCP_TRANSPORT
  • FASTMCP_SERVER_AUTH
  • MCP_AUTH_CLIENT_ID
  • DISABLED_TOOLS
  • FTS_RERANK_WINDOW_SIZE
  • FTS_RERANK_GAP_MERGE

Security Notes

The source code demonstrates strong security practices including: extensive input validation (e.g., regex for metadata keys), parameterized SQL queries to prevent injection, use of Pydantic's `SecretStr` for API keys and sensitive configuration, constant-time comparison for authentication tokens (`hmac.compare_digest`), and explicit mitigation of known PostgreSQL vulnerabilities (`CVE-2018-1058`). Input size limits are enforced for images and total requests. No obvious `eval` or obfuscation patterns were found. The system is designed with a clear separation of concerns (repository pattern) which aids maintainability and security auditing.

Similar Servers

Stats

Interest Score0
Security Score9
Cost ClassMedium
Avg Tokens400
Stars0
Forks0
Last Update2026-01-18

Tags

LLM Context ManagementMultimodal StorageSemantic SearchFull-Text SearchDatabase Backends