mcp-context-server MCP Setup & Guide
io.github.alex-feel/mcp-context-server · v2.2.2
An MCP server that provides persistent multimodal context storage for LLM agents.
Copy the install config on this page first, then verify docs and permissions upstream.
Overview
An MCP server that provides persistent multimodal context storage for LLM agents. mcp-context-server is a MCP Server listed from MCP Registry. Transports: stdio, streamable-http. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.
Use cases
AgentHub Verified AvailabilityTested & Ready
Automated pipeline validated install commands, protocol & client compatibility
Copy by platform
Choose your platform
- Open or create .cursor/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets (see Environment variables below)
- Save, then Cmd+Shift+P → Reload Window
Pre-fill Environment Variables (Optional)
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
]
}
}
}Setup tutorial
- Open the mcp-context-server page and confirm this MCP Server (source: MCP Registry).
- Copy the Cursor, Claude Code, or VS Code snippet.
- Merge it into mcpServers and replace env placeholders with real secrets.
- Reload the window, then call the MCP tools from your agent chat.
Install commands
Install commands and setup steps are in the HTML so search engines and no-JS browsers can read them without running client JavaScript.
Claude Code (local)
- Install Claude Code CLI
- Copy the command below, replace <placeholders> with real env values, then run in terminal
- See Environment variables below if listed
claude mcp add mcp-context-server -- uvx mcp-context-serverCursor — .cursor/mcp.json (local)
- Open or create .cursor/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets (see Environment variables below)
- Save, then Cmd+Shift+P → Reload Window
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
]
}
}
}VS Code — .vscode/mcp.json (local)
- Install GitHub Copilot in VS Code with MCP support
- Open or create .vscode/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets
- Save and Developer: Reload Window
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
]
}
}
}Claude Desktop — claude_desktop_config.json (local)
- Open Claude Desktop claude_desktop_config.json (see remote guide for paths)
- Click Copy config and merge under mcpServers
- Replace <placeholders> in env with real secrets
- Fully quit and restart Claude Desktop
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
]
}
}
}Trae — .trae/mcp.json (local)
- Trae → Settings → MCP, or edit .trae/mcp.json / global mcp.json
- Click Copy config and merge mcpServers
- Replace <placeholders> in env with real secrets
- Save and reload Trae
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
]
}
}
}Cherry Studio — MCP settings (local)
- Cherry Studio → Settings → MCP Servers → Add (STDIO)
- Or import JSON: click Copy config and merge mcpServers
- Replace <placeholders> in env; ensure Node.js / uv (npx, uvx) are installed
- Enable the server and check tools load
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
]
}
}
}Tongyi Lingma — MCP config (local)
- Lingma Settings → MCP → + → STDIO or config file
- Click Copy config and merge mcpServers
- Replace <placeholders> in env; need Node.js 18+ (npx) or uv (uvx)
- Confirm connected before using tools in agent chat
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
]
}
}
}Windsurf — mcp_config.json (local)
- Edit ~/.codeium/windsurf/mcp_config.json
- Click Copy config and merge mcpServers (stdio same as Cursor)
- Replace <placeholders> in env, save, refresh Cascade
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
]
}
}
}Cline — MCP Servers (local)
- Cline panel → Settings → MCP Servers
- Click Copy config and merge
- Replace <placeholders> in env, then save
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
]
}
}
}WorkBuddy — .workbuddy/mcp.json (local)
- Edit ~/.workbuddy/mcp.json (user) or project .workbuddy/mcp.json
- Or Plugins → MCP Servers → Configure MCP and paste the JSON below
- Replace <placeholders> in env; on Windows prefer absolute paths for command/scripts
- Save, restart WorkBuddy, confirm connector status is green
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
]
}
}
}Troubleshooting & Common ErrorsFAQ
Common connection errors and verified fixes for mcp-context-server
Getting 'connection closed' or exit code 1 in Cursor / Claude Code for mcp-context-server?
Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.
# Check binary path in terminal: which npx node -v
Getting 'spawn npx ENOENT' or 'command not found'?
The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).
Missing required environment variable or authentication failure?
mcp-context-server requires environment variables (LOG_LEVEL、STORAGE_BACKEND、MAX_IMAGE_SIZE_MB、MAX_TOTAL_SIZE_MB、DB_PATH、POOL_MAX_READERS、POOL_MAX_WRITERS、POOL_CONNECTION_TIMEOUT_S、POOL_IDLE_TIMEOUT_S、POOL_HEALTH_CHECK_INTERVAL_S、RETRY_MAX_RETRIES、RETRY_BASE_DELAY_S、RETRY_MAX_DELAY_S、RETRY_JITTER、RETRY_BACKOFF_FACTOR、SQLITE_FOREIGN_KEYS、SQLITE_JOURNAL_MODE、SQLITE_SYNCHRONOUS、SQLITE_TEMP_STORE、SQLITE_MMAP_SIZE、SQLITE_CACHE_SIZE、SQLITE_PAGE_SIZE、SQLITE_WAL_AUTOCHECKPOINT、SQLITE_BUSY_TIMEOUT_MS、SQLITE_WAL_CHECKPOINT、SHUTDOWN_TIMEOUT_S、SHUTDOWN_TIMEOUT_TEST_S、QUEUE_TIMEOUT_S、QUEUE_TIMEOUT_TEST_S、CIRCUIT_BREAKER_FAILURE_THRESHOLD、CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S、CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS、POSTGRESQL_CONNECTION_STRING、POSTGRESQL_HOST、POSTGRESQL_PORT、POSTGRESQL_USER、POSTGRESQL_PASSWORD、POSTGRESQL_DATABASE、POSTGRESQL_POOL_MIN、POSTGRESQL_POOL_MAX、POSTGRESQL_POOL_TIMEOUT_S、POSTGRESQL_COMMAND_TIMEOUT_S、POSTGRESQL_MIGRATION_TIMEOUT_S、POSTGRESQL_MAX_INACTIVE_LIFETIME_S、POSTGRESQL_MAX_QUERIES、POSTGRESQL_TCP_KEEPALIVES_IDLE_S、POSTGRESQL_TCP_KEEPALIVES_INTERVAL_S、POSTGRESQL_TCP_KEEPALIVES_COUNT、POSTGRESQL_STATEMENT_CACHE_SIZE、POSTGRESQL_MAX_CACHED_STATEMENT_LIFETIME_S、POSTGRESQL_MAX_CACHEABLE_STATEMENT_SIZE、POSTGRESQL_SSL_MODE、POSTGRESQL_SCHEMA、ENABLE_SEMANTIC_SEARCH、ENABLE_EMBEDDING_GENERATION、OLLAMA_HOST、OLLAMA_AUTO_PULL、OLLAMA_PULL_TIMEOUT_S、EMBEDDING_OLLAMA_TRUNCATE、EMBEDDING_OLLAMA_NUM_CTX、EMBEDDING_MODEL、EMBEDDING_DIM、EMBEDDING_TIMEOUT_S、EMBEDDING_RETRY_MAX_ATTEMPTS、EMBEDDING_RETRY_BASE_DELAY_S、EMBEDDING_MAX_CONCURRENT、ENABLE_SUMMARY_GENERATION、SUMMARY_PROVIDER、SUMMARY_MODEL、SUMMARY_MAX_TOKENS、SUMMARY_TIMEOUT_S、SUMMARY_RETRY_MAX_ATTEMPTS、SUMMARY_RETRY_BASE_DELAY_S、SUMMARY_MAX_CONCURRENT、SUMMARY_PROMPT、SUMMARY_MIN_CONTENT_LENGTH、SUMMARY_OLLAMA_NUM_CTX、SUMMARY_OLLAMA_TRUNCATE、SUMMARY_OPENAI_REASONING_EFFORT、SUMMARY_ANTHROPIC_EFFORT、ANTHROPIC_API_KEY、ENABLE_FTS、FTS_LANGUAGE、FTS_RERANK_WINDOW_SIZE、FTS_RERANK_GAP_MERGE、ENABLE_HYBRID_SEARCH、HYBRID_RRF_K、HYBRID_RRF_OVERFETCH、HYBRID_FTS_OR_THRESHOLD、SEARCH_DEFAULT_SORT_BY、SEARCH_TRUNCATION_LENGTH、ENABLE_CHUNKING、CHUNK_SIZE、CHUNK_OVERLAP、CHUNK_AGGREGATION、CHUNK_DEDUP_OVERFETCH、ENABLE_RERANKING、RERANKING_PROVIDER、RERANKING_MODEL、RERANKING_MAX_LENGTH、RERANKING_OVERFETCH、RERANKING_CACHE_DIR、RERANKING_CHARS_PER_TOKEN、RERANKING_INTRA_OP_THREADS、RERANKING_CPU_MEM_ARENA、RERANKING_BATCH_SIZE、EMBEDDING_PROVIDER、OPENAI_API_KEY、OPENAI_API_BASE、OPENAI_ORGANIZATION、AZURE_OPENAI_API_KEY、AZURE_OPENAI_ENDPOINT、AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME、AZURE_OPENAI_API_VERSION、HUGGINGFACEHUB_API_TOKEN、VOYAGE_API_KEY、VOYAGE_TRUNCATION、VOYAGE_BATCH_SIZE、LANGSMITH_TRACING、LANGSMITH_API_KEY、LANGSMITH_PROJECT、LANGSMITH_ENDPOINT、METADATA_INDEXED_FIELDS、METADATA_INDEX_SYNC_MODE、MCP_TRANSPORT、FASTMCP_HOST、FASTMCP_PORT、FASTMCP_STATELESS_HTTP、DISABLED_TOOLS、MCP_AUTH_TOKEN、MCP_AUTH_CLIENT_ID、MCP_AUTH_PROVIDER、MCP_SERVER_INSTRUCTIONS、LOG_LEVEL、STORAGE_BACKEND、MAX_IMAGE_SIZE_MB、MAX_TOTAL_SIZE_MB、DB_PATH、POOL_MAX_READERS、POOL_MAX_WRITERS、POOL_CONNECTION_TIMEOUT_S、POOL_IDLE_TIMEOUT_S、POOL_HEALTH_CHECK_INTERVAL_S、RETRY_MAX_RETRIES、RETRY_BASE_DELAY_S、RETRY_MAX_DELAY_S、RETRY_JITTER、RETRY_BACKOFF_FACTOR、SQLITE_FOREIGN_KEYS、SQLITE_JOURNAL_MODE、SQLITE_SYNCHRONOUS、SQLITE_TEMP_STORE、SQLITE_MMAP_SIZE、SQLITE_CACHE_SIZE、SQLITE_PAGE_SIZE、SQLITE_WAL_AUTOCHECKPOINT、SQLITE_BUSY_TIMEOUT_MS、SQLITE_WAL_CHECKPOINT、SHUTDOWN_TIMEOUT_S、SHUTDOWN_TIMEOUT_TEST_S、QUEUE_TIMEOUT_S、QUEUE_TIMEOUT_TEST_S、CIRCUIT_BREAKER_FAILURE_THRESHOLD、CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S、CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS、POSTGRESQL_CONNECTION_STRING、POSTGRESQL_HOST、POSTGRESQL_PORT、POSTGRESQL_USER、POSTGRESQL_PASSWORD、POSTGRESQL_DATABASE、POSTGRESQL_POOL_MIN、POSTGRESQL_POOL_MAX、POSTGRESQL_POOL_TIMEOUT_S、POSTGRESQL_COMMAND_TIMEOUT_S、POSTGRESQL_MIGRATION_TIMEOUT_S、POSTGRESQL_MAX_INACTIVE_LIFETIME_S、POSTGRESQL_MAX_QUERIES、POSTGRESQL_TCP_KEEPALIVES_IDLE_S、POSTGRESQL_TCP_KEEPALIVES_INTERVAL_S、POSTGRESQL_TCP_KEEPALIVES_COUNT、POSTGRESQL_STATEMENT_CACHE_SIZE、POSTGRESQL_MAX_CACHED_STATEMENT_LIFETIME_S、POSTGRESQL_MAX_CACHEABLE_STATEMENT_SIZE、POSTGRESQL_SSL_MODE、POSTGRESQL_SCHEMA、ENABLE_SEMANTIC_SEARCH、ENABLE_EMBEDDING_GENERATION、OLLAMA_HOST、OLLAMA_AUTO_PULL、OLLAMA_PULL_TIMEOUT_S、EMBEDDING_OLLAMA_TRUNCATE、EMBEDDING_OLLAMA_NUM_CTX、EMBEDDING_MODEL、EMBEDDING_DIM、EMBEDDING_TIMEOUT_S、EMBEDDING_RETRY_MAX_ATTEMPTS、EMBEDDING_RETRY_BASE_DELAY_S、EMBEDDING_MAX_CONCURRENT、ENABLE_SUMMARY_GENERATION、SUMMARY_PROVIDER、SUMMARY_MODEL、SUMMARY_MAX_TOKENS、SUMMARY_TIMEOUT_S、SUMMARY_RETRY_MAX_ATTEMPTS、SUMMARY_RETRY_BASE_DELAY_S、SUMMARY_MAX_CONCURRENT、SUMMARY_PROMPT、SUMMARY_MIN_CONTENT_LENGTH、SUMMARY_OLLAMA_NUM_CTX、SUMMARY_OLLAMA_TRUNCATE、SUMMARY_OPENAI_REASONING_EFFORT、SUMMARY_ANTHROPIC_EFFORT、ANTHROPIC_API_KEY、ENABLE_FTS、FTS_LANGUAGE、FTS_RERANK_WINDOW_SIZE、FTS_RERANK_GAP_MERGE、ENABLE_HYBRID_SEARCH、HYBRID_RRF_K、HYBRID_RRF_OVERFETCH、HYBRID_FTS_OR_THRESHOLD、SEARCH_DEFAULT_SORT_BY、SEARCH_TRUNCATION_LENGTH、ENABLE_CHUNKING、CHUNK_SIZE、CHUNK_OVERLAP、CHUNK_AGGREGATION、CHUNK_DEDUP_OVERFETCH、ENABLE_RERANKING、RERANKING_PROVIDER、RERANKING_MODEL、RERANKING_MAX_LENGTH、RERANKING_OVERFETCH、RERANKING_CACHE_DIR、RERANKING_CHARS_PER_TOKEN、RERANKING_INTRA_OP_THREADS、RERANKING_CPU_MEM_ARENA、RERANKING_BATCH_SIZE、EMBEDDING_PROVIDER、OPENAI_API_KEY、OPENAI_API_BASE、OPENAI_ORGANIZATION、AZURE_OPENAI_API_KEY、AZURE_OPENAI_ENDPOINT、AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME、AZURE_OPENAI_API_VERSION、HUGGINGFACEHUB_API_TOKEN、VOYAGE_API_KEY、VOYAGE_TRUNCATION、VOYAGE_BATCH_SIZE、LANGSMITH_TRACING、LANGSMITH_API_KEY、LANGSMITH_PROJECT、LANGSMITH_ENDPOINT、METADATA_INDEXED_FIELDS、METADATA_INDEX_SYNC_MODE、MCP_TRANSPORT、FASTMCP_HOST、FASTMCP_PORT、FASTMCP_STATELESS_HTTP、DISABLED_TOOLS、MCP_AUTH_TOKEN、MCP_AUTH_CLIENT_ID、MCP_AUTH_PROVIDER、MCP_SERVER_INSTRUCTIONS). Ensure you have added valid keys under the 'env' object in your config file without trailing whitespace.
// .cursor/mcp.json 或 claude_desktop_config.json
{
"env": {
"API_KEY": "your_actual_key_here"
}
}Tool Mock Playground
Sandboxmcp-context-server Tool Interface Simulation · Preview tool schema & outputs without local runtime
{
"target": "mcp-context-server",
"action": "execute",
"options": {
"mode": "standard",
"timeoutMs": 5000
}
}Click 'Run Mock' above
to preview the raw response returned to the LLM
Decision Guide: Why & When to Use
Assess suitability before installing to save trial-and-error time
- PR review
- Changelog generation
- Cross-repo issue search
- Replacing human security audit
- Unauthorized repo access
mcp-context-server + Scenario Prompt → Complete Agent Automation
MCP hands-on: install to visible results
Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.
Related resources
Playwright
io.mcp-cn.playwright/mcp
基于Playwright的自动化测试和网页操作MCP工具
微信读书
io.mcp-cn.mcp-server-weread
微信读书的MCP服务器,支持微信读书的读取和写入
Kubernetes
io.mcp-cn.mcp-server-kubernetes
Kubernetes的MCP服务器,支持Kubernetes的读取和写入
MarkItDown MCP Server
io.mcp-cn.markitdown-mcp-npx
MarkItDown MCP服务器,提供无Docker依赖的NPX包装器,支持直接运行Microsoft的markitdown-mcp服务器,包括自动Python环境设置和依赖管理
Figma
io.mcp-cn.figma-developer-mcp
连接Figma的MCP服务器,支持设计文件管理和操作
GitHub
io.mcp-cn.modelcontextprotocol/server-github
连接GitHub的MCP服务器,支持仓库管理、问题跟踪、代码搜索等功能
Often paired with
Tencent COS
v1.2.3
io.clawhub.shawnminh/tencent-cos-skill
腾讯云对象存储(COS)和数据万象(CI)集成技能。覆盖文件存储管理、AI处理和知识库三大核心场景。 存储场景:上传文件到云端、下载云端文件、批量管理存储桶文件、获取文件签名链接分享、查看文件元信息、查询数据万象及子服务开通状态。 图片处理场景:图片质量评估打分、AI超分辨率放大、AI智能裁剪、二维码/条形码识别、添加文字水印、获取图片EXIF信息、缩放、裁剪、旋转、格式转换。 文档处理场景:Word/Excel/PPT等办公文档转PDF、文档预览。 媒体处理场景:视频智能封面提取、视频转码、视频截帧、获取媒体信息。 内容审核场景:图片/视频/音频/文本/文档内容审核,检测违规内容。 智能语音
AI Persona OS
v2.1.0
io.clawhub.jeffjhunter/ai-persona-os
The complete operating layer for OpenClaw agents: 24-soul gallery, SOUL.md Maker, workspace templates, memory + security conventions, cron briefings, and in-chat commands. Needs OpenClaw 2026.8.1+.
中文公文写作
v2.0.51
io.clawhub.gongyu0918-debug/chinese-official-writing
用于中文公文、事务性材料和新闻稿件的起草、改写、压缩、润色、审校、文种核对、去口语化、降 AI 味及 Word 格式处理,适用于机关、企事业单位、学校和新闻机构。涵盖申请、请示、报告、通知、通告、意见、决定、决议、议案、公报、命令、函、复函、批复、说明、方案、纪要、公告、公示、通报、制度、规定、办法、细则、操作规程、工作要点、总结、调研、讲话、致辞、主持词、述职、可研、审查材料、技术需求、新闻消息、编者按、新闻评论,以及采购、整改、反馈和 AI 算力等场景。
得到大脑(原 Get 笔记)
v2.4.0
io.clawhub.iswalle/getnote
通过官方 getnote CLI 连接得到大脑,完成浏览器授权、连接诊断、CLI 升级,以及保存、查询、搜索和管理真实笔记。用户要按录音台或录音卡来源找笔记、保存链接/图片、上传文件到知识库、查询文件限制、读取标记/发芽报告/时间线、整理知识库/文件夹、订阅博主、管理标签,或明确要求登录、诊断或升级时使用;不会自行安装或更新 Skill。
Keep exploring AgentHub
Most people compare similar tools or check scenario guides before installing—start here.
Listing badge: put AgentHub on your site
Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.
<a href="https://myagenthub.cn/p/io.github.alex-feel/mcp-context-server" title="Listed on AgentHub: mcp-context-server" target="_blank" rel="noopener">
<img src="https://myagenthub.cn/badge/io.github.alex-feel/mcp-context-server?lang=en" alt="Listed on AgentHub: mcp-context-server" height="20" style="border:0"/>
</a>[](https://myagenthub.cn/p/io.github.alex-feel/mcp-context-server)Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.
Unified Manifest
{
"id": "io.github.alex-feel/mcp-context-server",
"type": "mcp-server",
"version": "2.2.2",
"displayName": "mcp-context-server",
"description": "An MCP server that provides persistent multimodal context storage for LLM agents.",
"repository": {
"url": "https://github.com/alex-feel/mcp-context-server",
"source": "github"
},
"distribution": {
"packages": [
{
"registryType": "pypi",
"identifier": "mcp-context-server",
"version": "2.2.2",
"transport": "stdio",
"environmentVariables": [
{
"name": "LOG_LEVEL",
"description": "Log level"
},
{
"name": "STORAGE_BACKEND",
"description": "Storage backend type: sqlite (default) or postgresql"
},
{
"name": "MAX_IMAGE_SIZE_MB",
"description": "Maximum individual image size in megabytes"
},
{
"name": "MAX_TOTAL_SIZE_MB",
"description": "Maximum total request size in megabytes"
},
{
"name": "DB_PATH",
"description": "Custom database file location path"
},
{
"name": "POOL_MAX_READERS",
"description": "Maximum number of concurrent read connections in the pool"
},
{
"name": "POOL_MAX_WRITERS",
"description": "Maximum number of concurrent write connections in the pool"
},
{
"name": "POOL_CONNECTION_TIMEOUT_S",
"description": "Connection timeout in seconds"
},
{
"name": "POOL_IDLE_TIMEOUT_S",
"description": "Idle connection timeout in seconds"
},
{
"name": "POOL_HEALTH_CHECK_INTERVAL_S",
"description": "Connection health check interval in seconds"
},
{
"name": "RETRY_MAX_RETRIES",
"description": "Maximum number of retry attempts for failed operations"
},
{
"name": "RETRY_BASE_DELAY_S",
"description": "Base delay in seconds between retry attempts"
},
{
"name": "RETRY_MAX_DELAY_S",
"description": "Maximum delay in seconds between retry attempts"
},
{
"name": "RETRY_JITTER",
"description": "Enable random jitter in retry delays"
},
{
"name": "RETRY_BACKOFF_FACTOR",
"description": "Exponential backoff multiplication factor for retries"
},
{
"name": "SQLITE_FOREIGN_KEYS",
"description": "Enable SQLite foreign key constraints"
},
{
"name": "SQLITE_JOURNAL_MODE",
"description": "SQLite journal mode (e.g., WAL, DELETE)"
},
{
"name": "SQLITE_SYNCHRONOUS",
"description": "SQLite synchronous mode (e.g., NORMAL, FULL, OFF)"
},
{
"name": "SQLITE_TEMP_STORE",
"description": "SQLite temporary storage location (e.g., MEMORY, FILE)"
},
{
"name": "SQLITE_MMAP_SIZE",
"description": "SQLite memory-mapped I/O size in bytes"
},
{
"name": "SQLITE_CACHE_SIZE",
"description": "SQLite cache size (negative value for KB, positive for pages)"
},
{
"name": "SQLITE_PAGE_SIZE",
"description": "SQLite page size in bytes"
},
{
"name": "SQLITE_WAL_AUTOCHECKPOINT",
"description": "SQLite WAL autocheckpoint threshold in pages"
},
{
"name": "SQLITE_BUSY_TIMEOUT_MS",
"description": "SQLite busy timeout in milliseconds"
},
{
"name": "SQLITE_WAL_CHECKPOINT",
"description": "SQLite WAL checkpoint mode (e.g., PASSIVE, FULL, RESTART)"
},
{
"name": "SHUTDOWN_TIMEOUT_S",
"description": "Server shutdown timeout in seconds"
},
{
"name": "SHUTDOWN_TIMEOUT_TEST_S",
"description": "Test mode shutdown timeout in seconds"
},
{
"name": "QUEUE_TIMEOUT_S",
"description": "Queue operation timeout in seconds"
},
{
"name": "QUEUE_TIMEOUT_TEST_S",
"description": "Test mode queue timeout in seconds"
},
{
"name": "CIRCUIT_BREAKER_FAILURE_THRESHOLD",
"description": "Circuit breaker failure threshold before opening"
},
{
"name": "CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S",
"description": "Circuit breaker recovery timeout in seconds"
},
{
"name": "CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS",
"description": "Maximum calls allowed in circuit breaker half-open state"
},
{
"name": "POSTGRESQL_CONNECTION_STRING",
"description": "Complete PostgreSQL connection string (overrides individual settings if provided)",
"isSecret": true
},
{
"name": "POSTGRESQL_HOST",
"description": "PostgreSQL server host address"
},
{
"name": "POSTGRESQL_PORT",
"description": "PostgreSQL server port number"
},
{
"name": "POSTGRESQL_USER",
"description": "PostgreSQL database username"
},
{
"name": "POSTGRESQL_PASSWORD",
"description": "PostgreSQL database password",
"isSecret": true
},
{
"name": "POSTGRESQL_DATABASE",
"description": "PostgreSQL database name"
},
{
"name": "POSTGRESQL_POOL_MIN",
"description": "PostgreSQL connection pool minimum size"
},
{
"name": "POSTGRESQL_POOL_MAX",
"description": "PostgreSQL connection pool maximum size"
},
{
"name": "POSTGRESQL_POOL_TIMEOUT_S",
"description": "PostgreSQL connection pool timeout in seconds"
},
{
"name": "POSTGRESQL_COMMAND_TIMEOUT_S",
"description": "PostgreSQL command execution timeout in seconds"
},
{
"name": "POSTGRESQL_MIGRATION_TIMEOUT_S",
"description": "Timeout in seconds for PostgreSQL migration operations (default: 300)"
},
{
"name": "POSTGRESQL_MAX_INACTIVE_LIFETIME_S",
"description": "Close idle PostgreSQL connections after this many seconds (0 to disable, default: 300)"
},
{
"name": "POSTGRESQL_MAX_QUERIES",
"description": "Recycle PostgreSQL connections after this many queries (0 to disable, default: 10000)"
},
{
"name": "POSTGRESQL_TCP_KEEPALIVES_IDLE_S",
"description": "Seconds of idle time before sending first TCP keepalive probe (0 to disable, default: 15)"
},
{
"name": "POSTGRESQL_TCP_KEEPALIVES_INTERVAL_S",
"description": "Seconds between subsequent TCP keepalive probes (0 to disable, default: 5)"
},
{
"name": "POSTGRESQL_TCP_KEEPALIVES_COUNT",
"description": "Number of failed TCP keepalive probes before connection is considered dead (0 to disable, default: 3)"
},
{
"name": "POSTGRESQL_STATEMENT_CACHE_SIZE",
"description": "asyncpg prepared statement cache size. Set to 0 for external pooler compatibility (PgBouncer transaction mode, Pgpool-II, etc.). Default: 100"
},
{
"name": "POSTGRESQL_MAX_CACHED_STATEMENT_LIFETIME_S",
"description": "Maximum lifetime of cached prepared statements in seconds (default: 300). Has no effect when statement_cache_size=0"
},
{
"name": "POSTGRESQL_MAX_CACHEABLE_STATEMENT_SIZE",
"description": "Maximum size of statement to cache in bytes (default: 15360). Has no effect when statement_cache_size=0"
},
{
"name": "POSTGRESQL_SSL_MODE",
"description": "PostgreSQL SSL mode (disable, allow, prefer, require, verify-ca, verify-full)"
},
{
"name": "POSTGRESQL_SCHEMA",
"description": "PostgreSQL schema name for table and index operations (default: public)"
},
{
"name": "ENABLE_SEMANTIC_SEARCH",
"description": "Enable semantic search functionality"
},
{
"name": "ENABLE_EMBEDDING_GENERATION",
"description": "Enable embedding generation for stored context. Default true - server fails if dependencies not met. Set false to disable embeddings."
},
{
"name": "OLLAMA_HOST",
"description": "Ollama API host URL for embedding generation"
},
{
"name": "OLLAMA_AUTO_PULL",
"description": "Automatically pull missing Ollama models on startup (default: true)"
},
{
"name": "OLLAMA_PULL_TIMEOUT_S",
"description": "Timeout in seconds for pulling Ollama models (default: 900, range: 30-3600)"
},
{
"name": "EMBEDDING_OLLAMA_TRUNCATE",
"description": "Ollama embedding truncation mode: false (default) returns error when context exceeded, true enables silent truncation"
},
{
"name": "EMBEDDING_OLLAMA_NUM_CTX",
"description": "Ollama embedding context window size in tokens (default: 4096, range: 512-2097152)"
},
{
"name": "EMBEDDING_MODEL",
"description": "Embedding model name for semantic search"
},
{
"name": "EMBEDDING_DIM",
"description": "Embedding vector dimensions"
},
{
"name": "EMBEDDING_TIMEOUT_S",
"description": "Timeout in seconds for embedding generation API calls"
},
{
"name": "EMBEDDING_RETRY_MAX_ATTEMPTS",
"description": "Maximum number of retry attempts for embedding generation"
},
{
"name": "EMBEDDING_RETRY_BASE_DELAY_S",
"description": "Base delay in seconds between retry attempts (with exponential backoff)"
},
{
"name": "EMBEDDING_MAX_CONCURRENT",
"description": "Maximum concurrent embedding generation operations (default: 3, range: 1-20)"
},
{
"name": "ENABLE_SUMMARY_GENERATION",
"description": "Enable summary generation for stored context. Default true - server fails if dependencies not met. Set false to disable summaries."
},
{
"name": "SUMMARY_PROVIDER",
"description": "Summary provider: ollama (default), openai, or anthropic"
},
{
"name": "SUMMARY_MODEL",
"description": "Summary generation model name (default: qwen3:0.6b)"
},
{
"name": "SUMMARY_MAX_TOKENS",
"description": "Maximum output tokens for summary generation (default: 4000, range: 50-16384). Increase if summaries are truncated by reasoning models"
},
{
"name": "SUMMARY_TIMEOUT_S",
"description": "Timeout in seconds for summary generation API calls"
},
{
"name": "SUMMARY_RETRY_MAX_ATTEMPTS",
"description": "Maximum number of retry attempts for summary generation"
},
{
"name": "SUMMARY_RETRY_BASE_DELAY_S",
"description": "Base delay in seconds between retry attempts (with exponential backoff)"
},
{
"name": "SUMMARY_MAX_CONCURRENT",
"description": "Maximum concurrent summary generation operations (default: 3, range: 1-20)"
},
{
"name": "SUMMARY_PROMPT",
"description": "Custom summarization prompt. Overrides the built-in default. Used as system message for the LLM."
},
{
"name": "SUMMARY_MIN_CONTENT_LENGTH",
"description": "Minimum text content length in characters to trigger summary generation (default: 500, range: 0-10000). Set to 0 to always generate."
},
{
"name": "SUMMARY_OLLAMA_NUM_CTX",
"description": "Ollama summary context window size in tokens (default: 32768, range: 512-2097152)"
},
{
"name": "SUMMARY_OLLAMA_TRUNCATE",
"description": "Ollama summary truncation mode: false (default) returns error when context exceeded, true enables silent truncation"
},
{
"name": "SUMMARY_OPENAI_REASONING_EFFORT",
"description": "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"
},
{
"name": "SUMMARY_ANTHROPIC_EFFORT",
"description": "Effort level for Anthropic Claude models (default: none). Valid values: max, high, medium, low. Controls inference effort (adaptive thinking)"
},
{
"name": "ANTHROPIC_API_KEY",
"description": "Anthropic API key for summary generation",
"isSecret": true
},
{
"name": "ENABLE_FTS",
"description": "Enable full-text search functionality"
},
{
"name": "FTS_LANGUAGE",
"description": "Language for FTS stemming (e.g., english, german, french)"
},
{
"name": "FTS_RERANK_WINDOW_SIZE",
"description": "Characters of context around each FTS match for reranking passage extraction (default: 750)"
},
{
"name": "FTS_RERANK_GAP_MERGE",
"description": "Merge FTS match regions within this character distance (default: 100)"
},
{
"name": "ENABLE_HYBRID_SEARCH",
"description": "Enable hybrid search combining FTS and semantic search with RRF fusion"
},
{
"name": "HYBRID_RRF_K",
"description": "RRF smoothing constant for hybrid search (default 60)"
},
{
"name": "HYBRID_RRF_OVERFETCH",
"description": "Multiplier for over-fetching results before RRF fusion (default: 2)"
},
{
"name": "HYBRID_FTS_OR_THRESHOLD",
"description": "Minimum significant query terms to switch hybrid FTS from AND to OR logic (default: 4)"
},
{
"name": "SEARCH_DEFAULT_SORT_BY",
"description": "Default sort order for search results: relevance (only 'relevance' supported in current version)"
},
{
"name": "SEARCH_TRUNCATION_LENGTH",
"description": "Maximum character length for truncated text_content in search results (default: 300, range: 50-1000)"
},
{
"name": "ENABLE_CHUNKING",
"description": "Enable text chunking for embedding generation (default: true)"
},
{
"name": "CHUNK_SIZE",
"description": "Target chunk size in characters (default: 1500)"
},
{
"name": "CHUNK_OVERLAP",
"description": "Overlap between chunks in characters (default: 150)"
},
{
"name": "CHUNK_AGGREGATION",
"description": "Chunk score aggregation method: max (only 'max' supported in current version)"
},
{
"name": "CHUNK_DEDUP_OVERFETCH",
"description": "Multiplier for over-fetching chunks before deduplication (default: 5)"
},
{
"name": "ENABLE_RERANKING",
"description": "Enable cross-encoder reranking of search results (default: true)"
},
{
"name": "RERANKING_PROVIDER",
"description": "Reranking provider (default: flashrank)"
},
{
"name": "RERANKING_MODEL",
"description": "Reranking model name (default: ms-marco-MiniLM-L-12-v2)"
},
{
"name": "RERANKING_MAX_LENGTH",
"description": "Maximum input length for reranking in tokens (default: 512)"
},
{
"name": "RERANKING_OVERFETCH",
"description": "Multiplier for over-fetching results before reranking (default: 4)"
},
{
"name": "RERANKING_CACHE_DIR",
"description": "Directory for caching reranking models"
},
{
"name": "RERANKING_CHARS_PER_TOKEN",
"description": "Estimated characters per token for passage size validation (default: 4.0, range: 2.0-8.0)"
},
{
"name": "RERANKING_INTRA_OP_THREADS",
"description": "ONNX Runtime intra-operation parallelism threads for reranking (default: 0 = auto-detect)"
},
{
"name": "RERANKING_CPU_MEM_ARENA",
"description": "Enable ONNX Runtime CPU memory arena for reranking (default: false)"
},
{
"name": "RERANKING_BATCH_SIZE",
"description": "Maximum passages per ONNX Runtime inference batch during reranking (default: 32)"
},
{
"name": "EMBEDDING_PROVIDER",
"description": "Embedding provider: ollama (default), openai, azure, huggingface, or voyage"
},
{
"name": "OPENAI_API_KEY",
"description": "OpenAI API key for OpenAI embedding provider",
"isSecret": true
},
{
"name": "OPENAI_API_BASE",
"description": "Custom base URL for OpenAI-compatible APIs"
},
{
"name": "OPENAI_ORGANIZATION",
"description": "OpenAI organization ID"
},
{
"name": "AZURE_OPENAI_API_KEY",
"description": "Azure OpenAI API key",
"isSecret": true
},
{
"name": "AZURE_OPENAI_ENDPOINT",
"description": "Azure OpenAI endpoint URL"
},
{
"name": "AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME",
"description": "Azure OpenAI embedding deployment name"
},
{
"name": "AZURE_OPENAI_API_VERSION",
"description": "Azure OpenAI API version (default: 2024-02-01)"
},
{
"name": "HUGGINGFACEHUB_API_TOKEN",
"description": "HuggingFace Hub API token for HuggingFace embedding provider",
"isSecret": true
},
{
"name": "VOYAGE_API_KEY",
"description": "Voyage AI API key for Voyage embedding provider",
"isSecret": true
},
{
"name": "VOYAGE_TRUNCATION",
"description": "Voyage AI truncation mode: false (default) returns error when context exceeded, true enables silent truncation"
},
{
"name": "VOYAGE_BATCH_SIZE",
"description": "Voyage AI batch size for embedding requests"
},
{
"name": "LANGSMITH_TRACING",
"description": "Enable LangSmith tracing"
},
{
"name": "LANGSMITH_API_KEY",
"description": "LangSmith API key",
"isSecret": true
},
{
"name": "LANGSMITH_PROJECT",
"description": "LangSmith project name"
},
{
"name": "LANGSMITH_ENDPOINT",
"description": "LangSmith API endpoint URL"
},
{
"name": "METADATA_INDEXED_FIELDS",
"description": "Comma-separated list of metadata fields to index (field:type format)"
},
{
"name": "METADATA_INDEX_SYNC_MODE",
"description": "Index sync mode: strict (fail), auto (sync), warn (log), additive (default, add missing only)"
},
{
"name": "MCP_TRANSPORT",
"description": "Transport mode: stdio for local, http for Docker/remote"
},
{
"name": "FASTMCP_HOST",
"description": "HTTP bind address (use 0.0.0.0 for Docker)"
},
{
"name": "FASTMCP_PORT",
"description": "HTTP port number"
},
{
"name": "FASTMCP_STATELESS_HTTP",
"description": "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."
},
{
"name": "DISABLED_TOOLS",
"description": "Comma-separated list of tools to disable (e.g., delete_context,update_context)"
},
{
"name": "MCP_AUTH_TOKEN",
"description": "Bearer token for HTTP authentication (required when using SimpleTokenVerifier)",
"isSecret": true
},
{
"name": "MCP_AUTH_CLIENT_ID",
"description": "Client ID to assign to authenticated requests"
},
{
"name": "MCP_AUTH_PROVIDER",
"description": "Authentication provider: none (default), simple_token"
},
{
"name": "MCP_SERVER_INSTRUCTIONS",
"description": "Custom server instructions text. Overrides built-in default. Set to empty string to disable."
}
]
},
{
"registryType": "oci",
"identifier": "ghcr.io/alex-feel/mcp-context-server:2.2.2",
"runtimeHint": "docker",
"transport": "streamable-http",
"environmentVariables": [
{
"name": "LOG_LEVEL",
"description": "Log level"
},
{
"name": "STORAGE_BACKEND",
"description": "Storage backend type: sqlite (default) or postgresql"
},
{
"name": "MAX_IMAGE_SIZE_MB",
"description": "Maximum individual image size in megabytes"
},
{
"name": "MAX_TOTAL_SIZE_MB",
"description": "Maximum total request size in megabytes"
},
{
"name": "DB_PATH",
"description": "Custom database file location path"
},
{
"name": "POOL_MAX_READERS",
"description": "Maximum number of concurrent read connections in the pool"
},
{
"name": "POOL_MAX_WRITERS",
"description": "Maximum number of concurrent write connections in the pool"
},
{
"name": "POOL_CONNECTION_TIMEOUT_S",
"description": "Connection timeout in seconds"
},
{
"name": "POOL_IDLE_TIMEOUT_S",
"description": "Idle connection timeout in seconds"
},
{
"name": "POOL_HEALTH_CHECK_INTERVAL_S",
"description": "Connection health check interval in seconds"
},
{
"name": "RETRY_MAX_RETRIES",
"description": "Maximum number of retry attempts for failed operations"
},
{
"name": "RETRY_BASE_DELAY_S",
"description": "Base delay in seconds between retry attempts"
},
{
"name": "RETRY_MAX_DELAY_S",
"description": "Maximum delay in seconds between retry attempts"
},
{
"name": "RETRY_JITTER",
"description": "Enable random jitter in retry delays"
},
{
"name": "RETRY_BACKOFF_FACTOR",
"description": "Exponential backoff multiplication factor for retries"
},
{
"name": "SQLITE_FOREIGN_KEYS",
"description": "Enable SQLite foreign key constraints"
},
{
"name": "SQLITE_JOURNAL_MODE",
"description": "SQLite journal mode (e.g., WAL, DELETE)"
},
{
"name": "SQLITE_SYNCHRONOUS",
"description": "SQLite synchronous mode (e.g., NORMAL, FULL, OFF)"
},
{
"name": "SQLITE_TEMP_STORE",
"description": "SQLite temporary storage location (e.g., MEMORY, FILE)"
},
{
"name": "SQLITE_MMAP_SIZE",
"description": "SQLite memory-mapped I/O size in bytes"
},
{
"name": "SQLITE_CACHE_SIZE",
"description": "SQLite cache size (negative value for KB, positive for pages)"
},
{
"name": "SQLITE_PAGE_SIZE",
"description": "SQLite page size in bytes"
},
{
"name": "SQLITE_WAL_AUTOCHECKPOINT",
"description": "SQLite WAL autocheckpoint threshold in pages"
},
{
"name": "SQLITE_BUSY_TIMEOUT_MS",
"description": "SQLite busy timeout in milliseconds"
},
{
"name": "SQLITE_WAL_CHECKPOINT",
"description": "SQLite WAL checkpoint mode (e.g., PASSIVE, FULL, RESTART)"
},
{
"name": "SHUTDOWN_TIMEOUT_S",
"description": "Server shutdown timeout in seconds"
},
{
"name": "SHUTDOWN_TIMEOUT_TEST_S",
"description": "Test mode shutdown timeout in seconds"
},
{
"name": "QUEUE_TIMEOUT_S",
"description": "Queue operation timeout in seconds"
},
{
"name": "QUEUE_TIMEOUT_TEST_S",
"description": "Test mode queue timeout in seconds"
},
{
"name": "CIRCUIT_BREAKER_FAILURE_THRESHOLD",
"description": "Circuit breaker failure threshold before opening"
},
{
"name": "CIRCUIT_BREAKER_RECOVERY_TIMEOUT_S",
"description": "Circuit breaker recovery timeout in seconds"
},
{
"name": "CIRCUIT_BREAKER_HALF_OPEN_MAX_CALLS",
"description": "Maximum calls allowed in circuit breaker half-open state"
},
{
"name": "POSTGRESQL_CONNECTION_STRING",
"description": "Complete PostgreSQL connection string (overrides individual settings if provided)",
"isSecret": true
},
{
"name": "POSTGRESQL_HOST",
"description": "PostgreSQL server host address"
},
{
"name": "POSTGRESQL_PORT",
"description": "PostgreSQL server port number"
},
{
"name": "POSTGRESQL_USER",
"description": "PostgreSQL database username"
},
{
"name": "POSTGRESQL_PASSWORD",
"description": "PostgreSQL database password",
"isSecret": true
},
{
"name": "POSTGRESQL_DATABASE",
"description": "PostgreSQL database name"
},
{
"name": "POSTGRESQL_POOL_MIN",
"description": "PostgreSQL connection pool minimum size"
},
{
"name": "POSTGRESQL_POOL_MAX",
"description": "PostgreSQL connection pool maximum size"
},
{
"name": "POSTGRESQL_POOL_TIMEOUT_S",
"description": "PostgreSQL connection pool timeout in seconds"
},
{
"name": "POSTGRESQL_COMMAND_TIMEOUT_S",
"description": "PostgreSQL command execution timeout in seconds"
},
{
"name": "POSTGRESQL_MIGRATION_TIMEOUT_S",
"description": "Timeout in seconds for PostgreSQL migration operations (default: 300)"
},
{
"name": "POSTGRESQL_MAX_INACTIVE_LIFETIME_S",
"description": "Close idle PostgreSQL connections after this many seconds (0 to disable, default: 300)"
},
{
"name": "POSTGRESQL_MAX_QUERIES",
"description": "Recycle PostgreSQL connections after this many queries (0 to disable, default: 10000)"
},
{
"name": "POSTGRESQL_TCP_KEEPALIVES_IDLE_S",
"description": "Seconds of idle time before sending first TCP keepalive probe (0 to disable, default: 15)"
},
{
"name": "POSTGRESQL_TCP_KEEPALIVES_INTERVAL_S",
"description": "Seconds between subsequent TCP keepalive probes (0 to disable, default: 5)"
},
{
"name": "POSTGRESQL_TCP_KEEPALIVES_COUNT",
"description": "Number of failed TCP keepalive probes before connection is considered dead (0 to disable, default: 3)"
},
{
"name": "POSTGRESQL_STATEMENT_CACHE_SIZE",
"description": "asyncpg prepared statement cache size. Set to 0 for external pooler compatibility (PgBouncer transaction mode, Pgpool-II, etc.). Default: 100"
},
{
"name": "POSTGRESQL_MAX_CACHED_STATEMENT_LIFETIME_S",
"description": "Maximum lifetime of cached prepared statements in seconds (default: 300). Has no effect when statement_cache_size=0"
},
{
"name": "POSTGRESQL_MAX_CACHEABLE_STATEMENT_SIZE",
"description": "Maximum size of statement to cache in bytes (default: 15360). Has no effect when statement_cache_size=0"
},
{
"name": "POSTGRESQL_SSL_MODE",
"description": "PostgreSQL SSL mode (disable, allow, prefer, require, verify-ca, verify-full)"
},
{
"name": "POSTGRESQL_SCHEMA",
"description": "PostgreSQL schema name for table and index operations (default: public)"
},
{
"name": "ENABLE_SEMANTIC_SEARCH",
"description": "Enable semantic search functionality"
},
{
"name": "ENABLE_EMBEDDING_GENERATION",
"description": "Enable embedding generation for stored context. Default true - server fails if dependencies not met. Set false to disable embeddings."
},
{
"name": "OLLAMA_HOST",
"description": "Ollama API host URL for embedding generation"
},
{
"name": "OLLAMA_AUTO_PULL",
"description": "Automatically pull missing Ollama models on startup (default: true)"
},
{
"name": "OLLAMA_PULL_TIMEOUT_S",
"description": "Timeout in seconds for pulling Ollama models (default: 900, range: 30-3600)"
},
{
"name": "EMBEDDING_OLLAMA_TRUNCATE",
"description": "Ollama embedding truncation mode: false (default) returns error when context exceeded, true enables silent truncation"
},
{
"name": "EMBEDDING_OLLAMA_NUM_CTX",
"description": "Ollama embedding context window size in tokens (default: 4096, range: 512-2097152)"
},
{
"name": "EMBEDDING_MODEL",
"description": "Embedding model name for semantic search"
},
{
"name": "EMBEDDING_DIM",
"description": "Embedding vector dimensions"
},
{
"name": "EMBEDDING_TIMEOUT_S",
"description": "Timeout in seconds for embedding generation API calls"
},
{
"name": "EMBEDDING_RETRY_MAX_ATTEMPTS",
"description": "Maximum number of retry attempts for embedding generation"
},
{
"name": "EMBEDDING_RETRY_BASE_DELAY_S",
"description": "Base delay in seconds between retry attempts (with exponential backoff)"
},
{
"name": "EMBEDDING_MAX_CONCURRENT",
"description": "Maximum concurrent embedding generation operations (default: 3, range: 1-20)"
},
{
"name": "ENABLE_SUMMARY_GENERATION",
"description": "Enable summary generation for stored context. Default true - server fails if dependencies not met. Set false to disable summaries."
},
{
"name": "SUMMARY_PROVIDER",
"description": "Summary provider: ollama (default), openai, or anthropic"
},
{
"name": "SUMMARY_MODEL",
"description": "Summary generation model name (default: qwen3:0.6b)"
},
{
"name": "SUMMARY_MAX_TOKENS",
"description": "Maximum output tokens for summary generation (default: 4000, range: 50-16384). Increase if summaries are truncated by reasoning models"
},
{
"name": "SUMMARY_TIMEOUT_S",
"description": "Timeout in seconds for summary generation API calls"
},
{
"name": "SUMMARY_RETRY_MAX_ATTEMPTS",
"description": "Maximum number of retry attempts for summary generation"
},
{
"name": "SUMMARY_RETRY_BASE_DELAY_S",
"description": "Base delay in seconds between retry attempts (with exponential backoff)"
},
{
"name": "SUMMARY_MAX_CONCURRENT",
"description": "Maximum concurrent summary generation operations (default: 3, range: 1-20)"
},
{
"name": "SUMMARY_PROMPT",
"description": "Custom summarization prompt. Overrides the built-in default. Used as system message for the LLM."
},
{
"name": "SUMMARY_MIN_CONTENT_LENGTH",
"description": "Minimum text content length in characters to trigger summary generation (default: 500, range: 0-10000). Set to 0 to always generate."
},
{
"name": "SUMMARY_OLLAMA_NUM_CTX",
"description": "Ollama summary context window size in tokens (default: 32768, range: 512-2097152)"
},
{
"name": "SUMMARY_OLLAMA_TRUNCATE",
"description": "Ollama summary truncation mode: false (default) returns error when context exceeded, true enables silent truncation"
},
{
"name": "SUMMARY_OPENAI_REASONING_EFFORT",
"description": "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"
},
{
"name": "SUMMARY_ANTHROPIC_EFFORT",
"description": "Effort level for Anthropic Claude models (default: none). Valid values: max, high, medium, low. Controls inference effort (adaptive thinking)"
},
{
"name": "ANTHROPIC_API_KEY",
"description": "Anthropic API key for summary generation",
"isSecret": true
},
{
"name": "ENABLE_FTS",
"description": "Enable full-text search functionality"
},
{
"name": "FTS_LANGUAGE",
"description": "Language for FTS stemming (e.g., english, german, french)"
},
{
"name": "FTS_RERANK_WINDOW_SIZE",
"description": "Characters of context around each FTS match for reranking passage extraction (default: 750)"
},
{
"name": "FTS_RERANK_GAP_MERGE",
"description": "Merge FTS match regions within this character distance (default: 100)"
},
{
"name": "ENABLE_HYBRID_SEARCH",
"description": "Enable hybrid search combining FTS and semantic search with RRF fusion"
},
{
"name": "HYBRID_RRF_K",
"description": "RRF smoothing constant for hybrid search (default 60)"
},
{
"name": "HYBRID_RRF_OVERFETCH",
"description": "Multiplier for over-fetching results before RRF fusion (default: 2)"
},
{
"name": "HYBRID_FTS_OR_THRESHOLD",
"description": "Minimum significant query terms to switch hybrid FTS from AND to OR logic (default: 4)"
},
{
"name": "SEARCH_DEFAULT_SORT_BY",
"description": "Default sort order for search results: relevance (only 'relevance' supported in current version)"
},
{
"name": "SEARCH_TRUNCATION_LENGTH",
"description": "Maximum character length for truncated text_content in search results (default: 300, range: 50-1000)"
},
{
"name": "ENABLE_CHUNKING",
"description": "Enable text chunking for embedding generation (default: true)"
},
{
"name": "CHUNK_SIZE",
"description": "Target chunk size in characters (default: 1500)"
},
{
"name": "CHUNK_OVERLAP",
"description": "Overlap between chunks in characters (default: 150)"
},
{
"name": "CHUNK_AGGREGATION",
"description": "Chunk score aggregation method: max (only 'max' supported in current version)"
},
{
"name": "CHUNK_DEDUP_OVERFETCH",
"description": "Multiplier for over-fetching chunks before deduplication (default: 5)"
},
{
"name": "ENABLE_RERANKING",
"description": "Enable cross-encoder reranking of search results (default: true)"
},
{
"name": "RERANKING_PROVIDER",
"description": "Reranking provider (default: flashrank)"
},
{
"name": "RERANKING_MODEL",
"description": "Reranking model name (default: ms-marco-MiniLM-L-12-v2)"
},
{
"name": "RERANKING_MAX_LENGTH",
"description": "Maximum input length for reranking in tokens (default: 512)"
},
{
"name": "RERANKING_OVERFETCH",
"description": "Multiplier for over-fetching results before reranking (default: 4)"
},
{
"name": "RERANKING_CACHE_DIR",
"description": "Directory for caching reranking models"
},
{
"name": "RERANKING_CHARS_PER_TOKEN",
"description": "Estimated characters per token for passage size validation (default: 4.0, range: 2.0-8.0)"
},
{
"name": "RERANKING_INTRA_OP_THREADS",
"description": "ONNX Runtime intra-operation parallelism threads for reranking (default: 0 = auto-detect)"
},
{
"name": "RERANKING_CPU_MEM_ARENA",
"description": "Enable ONNX Runtime CPU memory arena for reranking (default: false)"
},
{
"name": "RERANKING_BATCH_SIZE",
"description": "Maximum passages per ONNX Runtime inference batch during reranking (default: 32)"
},
{
"name": "EMBEDDING_PROVIDER",
"description": "Embedding provider: ollama (default), openai, azure, huggingface, or voyage"
},
{
"name": "OPENAI_API_KEY",
"description": "OpenAI API key for OpenAI embedding provider",
"isSecret": true
},
{
"name": "OPENAI_API_BASE",
"description": "Custom base URL for OpenAI-compatible APIs"
},
{
"name": "OPENAI_ORGANIZATION",
"description": "OpenAI organization ID"
},
{
"name": "AZURE_OPENAI_API_KEY",
"description": "Azure OpenAI API key",
"isSecret": true
},
{
"name": "AZURE_OPENAI_ENDPOINT",
"description": "Azure OpenAI endpoint URL"
},
{
"name": "AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME",
"description": "Azure OpenAI embedding deployment name"
},
{
"name": "AZURE_OPENAI_API_VERSION",
"description": "Azure OpenAI API version (default: 2024-02-01)"
},
{
"name": "HUGGINGFACEHUB_API_TOKEN",
"description": "HuggingFace Hub API token for HuggingFace embedding provider",
"isSecret": true
},
{
"name": "VOYAGE_API_KEY",
"description": "Voyage AI API key for Voyage embedding provider",
"isSecret": true
},
{
"name": "VOYAGE_TRUNCATION",
"description": "Voyage AI truncation mode: false (default) returns error when context exceeded, true enables silent truncation"
},
{
"name": "VOYAGE_BATCH_SIZE",
"description": "Voyage AI batch size for embedding requests"
},
{
"name": "LANGSMITH_TRACING",
"description": "Enable LangSmith tracing"
},
{
"name": "LANGSMITH_API_KEY",
"description": "LangSmith API key",
"isSecret": true
},
{
"name": "LANGSMITH_PROJECT",
"description": "LangSmith project name"
},
{
"name": "LANGSMITH_ENDPOINT",
"description": "LangSmith API endpoint URL"
},
{
"name": "METADATA_INDEXED_FIELDS",
"description": "Comma-separated list of metadata fields to index (field:type format)"
},
{
"name": "METADATA_INDEX_SYNC_MODE",
"description": "Index sync mode: strict (fail), auto (sync), warn (log), additive (default, add missing only)"
},
{
"name": "MCP_TRANSPORT",
"description": "Transport mode: stdio for local, http for Docker/remote"
},
{
"name": "FASTMCP_HOST",
"description": "HTTP bind address (use 0.0.0.0 for Docker)"
},
{
"name": "FASTMCP_PORT",
"description": "HTTP port number"
},
{
"name": "FASTMCP_STATELESS_HTTP",
"description": "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."
},
{
"name": "DISABLED_TOOLS",
"description": "Comma-separated list of tools to disable (e.g., delete_context,update_context)"
},
{
"name": "MCP_AUTH_TOKEN",
"description": "Bearer token for HTTP authentication (required when using SimpleTokenVerifier)",
"isSecret": true
},
{
"name": "MCP_AUTH_CLIENT_ID",
"description": "Client ID to assign to authenticated requests"
},
{
"name": "MCP_AUTH_PROVIDER",
"description": "Authentication provider: none (default), simple_token"
},
{
"name": "MCP_SERVER_INSTRUCTIONS",
"description": "Custom server instructions text. Overrides built-in default. Set to empty string to disable."
}
]
}
],
"remotes": []
},
"dependencies": [],
"installTargets": [
"claude-code",
"claude-desktop",
"cursor",
"vscode",
"trae",
"cherry-studio",
"lingma",
"windsurf",
"cline",
"workbuddy"
],
"keywords": [],
"provenance": {
"origin": "official-mcp-registry",
"originalId": "io.github.alex-feel/mcp-context-server",
"originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.alex-feel%2Fmcp-context-server/versions/latest",
"isOfficial": true,
"status": "active"
}
}