Skip to content
Cursor

mcp context server for Cursor

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

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

client:Cursor transport:stdio runtime:pypi

Install mcp context server in Cursor

~/.cursor/mcp.json · windows: %USERPROFILE%\.cursor\mcp.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "mcp-context-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-context-server"
      ],
      "env": {
        "LOG_LEVEL": "<LOG_LEVEL>",
        "STORAGE_BACKEND": "<STORAGE_BACKEND>",
        "MAX_IMAGE_SIZE_MB": "<MAX_IMAGE_SIZE_MB>",
        "MAX_TOTAL_SIZE_MB": "<MAX_TOTAL_SIZE_MB>",
        "DB_PATH": "<DB_PATH>",
        "POOL_MAX_READERS": "<POOL_MAX_READERS>",
        "POOL_MAX_WRITERS": "<POOL_MAX_WRITERS>",
        "POOL_CONNECTION_TIMEOUT_S": "<POOL_CONNECTION_TIMEOUT_S>",
        "POOL_IDLE_TIMEOUT_S": "<POOL_IDLE_TIMEOUT_S>",
        "POOL_HEALTH_CHECK_INTERVAL_S": "<POOL_HEALTH_CHECK_INTERVAL_S>",
        "RETRY_MAX_RETRIES": "<RETRY_MAX_RETRIES>",
        "RETRY_BASE_DELAY_S": "<RETRY_BASE_DELAY_S>",
        "RETRY_MAX_DELAY_S": "<RETRY_MAX_DELAY_S>",
        "RETRY_JITTER": "<RETRY_JITTER>",
        "RETRY_BACKOFF_FACTOR": "<RETRY_BACKOFF_FACTOR>",
        "SQLITE_FOREIGN_KEYS": "<SQLITE_FOREIGN_KEYS>",
        "SQLITE_JOURNAL_MODE": "<SQLITE_JOURNAL_MODE>",
        "SQLITE_SYNCHRONOUS": "<SQLITE_SYNCHRONOUS>",
        "SQLITE_TEMP_STORE": "<SQLITE_TEMP_STORE>",
        "SQLITE_MMAP_SIZE": "<SQLITE_MMAP_SIZE>",
        "SQLITE_CACHE_SIZE": "<SQLITE_CACHE_SIZE>",
        "SQLITE_PAGE_SIZE": "<SQLITE_PAGE_SIZE>",
        "SQLITE_WAL_AUTOCHECKPOINT": "<SQLITE_WAL_AUTOCHECKPOINT>",
        "SQLITE_BUSY_TIMEOUT_MS": "<SQLITE_BUSY_TIMEOUT_MS>",
        "SQLITE_WAL_CHECKPOINT": "<SQLITE_WAL_CHECKPOINT>",
        "SHUTDOWN_TIMEOUT_S": "<SHUTDOWN_TIMEOUT_S>",
        "SHUTDOWN_TIMEOUT_TEST_S": "<SHUTDOWN_TIMEOUT_TEST_S>",
        "QUEUE_TIMEOUT_S": "<QUEUE_TIMEOUT_S>",
        "QUEUE_TIMEOUT_TEST_S": "<QUEUE_TIMEOUT_TEST_S>",
        "CIRCUIT_BREAKER_FAILURE_THRESHOLD": "<CIRCUIT_BREAKER_FAILURE_THRESHOLD>",
        "CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S": "<CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S>",
        "CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS": "<CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS>",
        "POSTGRESQL_CONNECTION_STRING": "<POSTGRESQL_CONNECTION_STRING>",
        "POSTGRESQL_HOST": "<POSTGRESQL_HOST>",
        "POSTGRESQL_PORT": "<POSTGRESQL_PORT>",
        "POSTGRESQL_USER": "<POSTGRESQL_USER>",
        "POSTGRESQL_PASSWORD": "<POSTGRESQL_PASSWORD>",
        "POSTGRESQL_DATABASE": "<POSTGRESQL_DATABASE>",
        "POSTGRESQL_POOL_MIN": "<POSTGRESQL_POOL_MIN>",
        "POSTGRESQL_POOL_MAX": "<POSTGRESQL_POOL_MAX>",
        "POSTGRESQL_POOL_TIMEOUT_S": "<POSTGRESQL_POOL_TIMEOUT_S>",
        "POSTGRESQL_COMMAND_TIMEOUT_S": "<POSTGRESQL_COMMAND_TIMEOUT_S>",
        "POSTGRESQL_MIGRATION_TIMEOUT_S": "<POSTGRESQL_MIGRATION_TIMEOUT_S>",
        "POSTGRESQL_MAX_INACTIVE_LIFETIME_S": "<POSTGRESQL_MAX_INACTIVE_LIFETIME_S>",
        "POSTGRESQL_MAX_QUERIES": "<POSTGRESQL_MAX_QUERIES>",
        "POSTGRESQL_TCP_KEEPALIVES_IDLE_S": "<POSTGRESQL_TCP_KEEPALIVES_IDLE_S>",
        "POSTGRESQL_TCP_KEEPALIVES_INTERVAL_S": "<POSTGRESQL_TCP_KEEPALIVES_INTERVAL_S>",
        "POSTGRESQL_TCP_KEEPALIVES_COUNT": "<POSTGRESQL_TCP_KEEPALIVES_COUNT>",
        "POSTGRESQL_STATEMENT_CACHE_SIZE": "<POSTGRESQL_STATEMENT_CACHE_SIZE>",
        "POSTGRESQL_MAX_CACHED_STATEMENT_LIFETIME_S": "<POSTGRESQL_MAX_CACHED_STATEMENT_LIFETIME_S>",
        "POSTGRESQL_MAX_CACHEABLE_STATEMENT_SIZE": "<POSTGRESQL_MAX_CACHEABLE_STATEMENT_SIZE>",
        "POSTGRESQL_SSL_MODE": "<POSTGRESQL_SSL_MODE>",
        "POSTGRESQL_SCHEMA": "<POSTGRESQL_SCHEMA>",
        "ENABLE_SEMANTIC_SEARCH": "<ENABLE_SEMANTIC_SEARCH>",
        "ENABLE_EMBEDDING_GENERATION": "<ENABLE_EMBEDDING_GENERATION>",
        "OLLAMA_HOST": "<OLLAMA_HOST>",
        "OLLAMA_AUTO_PULL": "<OLLAMA_AUTO_PULL>",
        "OLLAMA_PULL_TIMEOUT_S": "<OLLAMA_PULL_TIMEOUT_S>",
        "EMBEDDING_OLLAMA_TRUNCATE": "<EMBEDDING_OLLAMA_TRUNCATE>",
        "EMBEDDING_OLLAMA_NUM_CTX": "<EMBEDDING_OLLAMA_NUM_CTX>",
        "EMBEDDING_MODEL": "<EMBEDDING_MODEL>",
        "EMBEDDING_DIM": "<EMBEDDING_DIM>",
        "EMBEDDING_TIMEOUT_S": "<EMBEDDING_TIMEOUT_S>",
        "EMBEDDING_RETRY_MAX_ATTEMPTS": "<EMBEDDING_RETRY_MAX_ATTEMPTS>",
        "EMBEDDING_RETRY_BASE_DELAY_S": "<EMBEDDING_RETRY_BASE_DELAY_S>",
        "EMBEDDING_MAX_CONCURRENT": "<EMBEDDING_MAX_CONCURRENT>",
        "ENABLE_SUMMARY_GENERATION": "<ENABLE_SUMMARY_GENERATION>",
        "SUMMARY_PROVIDER": "<SUMMARY_PROVIDER>",
        "SUMMARY_MODEL": "<SUMMARY_MODEL>",
        "SUMMARY_MAX_TOKENS": "<SUMMARY_MAX_TOKENS>",
        "SUMMARY_TIMEOUT_S": "<SUMMARY_TIMEOUT_S>",
        "SUMMARY_RETRY_MAX_ATTEMPTS": "<SUMMARY_RETRY_MAX_ATTEMPTS>",
        "SUMMARY_RETRY_BASE_DELAY_S": "<SUMMARY_RETRY_BASE_DELAY_S>",
        "SUMMARY_MAX_CONCURRENT": "<SUMMARY_MAX_CONCURRENT>",
        "SUMMARY_PROMPT": "<SUMMARY_PROMPT>",
        "SUMMARY_MIN_CONTENT_LENGTH": "<SUMMARY_MIN_CONTENT_LENGTH>",
        "SUMMARY_OLLAMA_NUM_CTX": "<SUMMARY_OLLAMA_NUM_CTX>",
        "SUMMARY_OLLAMA_TRUNCATE": "<SUMMARY_OLLAMA_TRUNCATE>",
        "SUMMARY_OPENAI_REASONING_EFFORT": "<SUMMARY_OPENAI_REASONING_EFFORT>",
        "SUMMARY_ANTHROPIC_EFFORT": "<SUMMARY_ANTHROPIC_EFFORT>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "ENABLE_FTS": "<ENABLE_FTS>",
        "FTS_LANGUAGE": "<FTS_LANGUAGE>",
        "FTS_RERANK_WINDOW_SIZE": "<FTS_RERANK_WINDOW_SIZE>",
        "FTS_RERANK_GAP_MERGE": "<FTS_RERANK_GAP_MERGE>",
        "ENABLE_HYBRID_SEARCH": "<ENABLE_HYBRID_SEARCH>",
        "HYBRID_RRF_K": "<HYBRID_RRF_K>",
        "HYBRID_RRF_OVERFETCH": "<HYBRID_RRF_OVERFETCH>",
        "HYBRID_FTS_OR_THRESHOLD": "<HYBRID_FTS_OR_THRESHOLD>",
        "SEARCH_DEFAULT_SORT_BY": "<SEARCH_DEFAULT_SORT_BY>",
        "SEARCH_TRUNCATION_LENGTH": "<SEARCH_TRUNCATION_LENGTH>",
        "ENABLE_CHUNKING": "<ENABLE_CHUNKING>",
        "CHUNK_SIZE": "<CHUNK_SIZE>",
        "CHUNK_OVERLAP": "<CHUNK_OVERLAP>",
        "CHUNK_AGGREGATION": "<CHUNK_AGGREGATION>",
        "CHUNK_DEDUP_OVERFETCH": "<CHUNK_DEDUP_OVERFETCH>",
        "ENABLE_RERANKING": "<ENABLE_RERANKING>",
        "RERANKING_PROVIDER": "<RERANKING_PROVIDER>",
        "RERANKING_MODEL": "<RERANKING_MODEL>",
        "RERANKING_MAX_LENGTH": "<RERANKING_MAX_LENGTH>",
        "RERANKING_OVERFETCH": "<RERANKING_OVERFETCH>",
        "RERANKING_CACHE_DIR": "<RERANKING_CACHE_DIR>",
        "RERANKING_CHARS_PER_TOKEN": "<RERANKING_CHARS_PER_TOKEN>",
        "RERANKING_INTRA_OP_THREADS": "<RERANKING_INTRA_OP_THREADS>",
        "RERANKING_CPU_MEM_ARENA": "<RERANKING_CPU_MEM_ARENA>",
        "RERANKING_BATCH_SIZE": "<RERANKING_BATCH_SIZE>",
        "EMBEDDING_PROVIDER": "<EMBEDDING_PROVIDER>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "OPENAI_API_BASE": "<OPENAI_API_BASE>",
        "OPENAI_ORGANIZATION": "<OPENAI_ORGANIZATION>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>",
        "AZURE_OPENAI_ENDPOINT": "<AZURE_OPENAI_ENDPOINT>",
        "AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME": "<AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME>",
        "AZURE_OPENAI_API_VERSION": "<AZURE_OPENAI_API_VERSION>",
        "HUGGINGFACEHUB_API_TOKEN": "<HUGGINGFACEHUB_API_TOKEN>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
        "VOYAGE_TRUNCATION": "<VOYAGE_TRUNCATION>",
        "VOYAGE_BATCH_SIZE": "<VOYAGE_BATCH_SIZE>",
        "LANGSMITH_TRACING": "<LANGSMITH_TRACING>",
        "LANGSMITH_API_KEY": "<LANGSMITH_API_KEY>",
        "LANGSMITH_PROJECT": "<LANGSMITH_PROJECT>",
        "LANGSMITH_ENDPOINT": "<LANGSMITH_ENDPOINT>",
        "METADATA_INDEXED_FIELDS": "<METADATA_INDEXED_FIELDS>",
        "METADATA_INDEX_SYNC_MODE": "<METADATA_INDEX_SYNC_MODE>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "FASTMCP_HOST": "<FASTMCP_HOST>",
        "FASTMCP_PORT": "<FASTMCP_PORT>",
        "FASTMCP_STATELESS_HTTP": "<FASTMCP_STATELESS_HTTP>",
        "DISABLED_TOOLS": "<DISABLED_TOOLS>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>",
        "MCP_AUTH_CLIENT_ID": "<MCP_AUTH_CLIENT_ID>",
        "MCP_AUTH_PROVIDER": "<MCP_AUTH_PROVIDER>",
        "MCP_SERVER_INSTRUCTIONS": "<MCP_SERVER_INSTRUCTIONS>"
      }
    }
  }
}

Use .cursor/mcp.json in a project root instead to scope it to that project. Cursor merges both. Cursor docs

mcp context server in other clients