MCP上下文服务器
一种高性能的模型上下文协议(MCP)服务器,为LLM代理提供持久的多模式上下文存储。该服务器采用FastMCP构建,通过基于线程的作用域,实现了在处理同一任务的多个代理之间的无缝上下文共享。
主要特点
- 多模式上下文存储:存储和检索文本和图像
- 基于线程的范围界定:处理同一任务的代理通过线程ID共享上下文
- 灵活的元数据过滤:使用任何JSON可序列化字段存储自定义结构化数据,并使用16个强大的运算符进行筛选
- 日期范围筛选:使用ISO 8601格式按创建时间戳过滤上下文条目
- 基于标签的组织:使用规范化的索引标签进行高效的上下文检索
- 摘要生成:可选的基于LLM的自动摘要与截断的摘要一起返回
text_content在所有搜索工具结果中,为了提高代理上下文效率(Ollama默认启用) - 全文检索:可选的语言搜索,包括词干、排名、布尔查询(FTS5/tsvector)和跨编码器重新排名
- 语义搜索:用于基于意义的检索的可选矢量相似性搜索,具有交叉编码器重新排序功能
- 混合搜索:可选的组合FTS+语义搜索,使用具有交叉编码器重新排序的交互秩融合(RRF)
- 交叉编码器重新排序:使用FlashRank交叉编码器模型自动优化结果,以提高搜索精度(默认启用)
- 多个数据库后端:在SQLite(默认,零配置)或PostgreSQL(高并发,生产级)之间进行选择
- 高性能:WAL模式(SQLite)/MVCC(PostgreSQL)、策略索引和异步操作
- MCP标准合规性:适用于Claude Code、LangGraph和任何兼容MCP的客户端
- 生产就绪:全面的测试覆盖率、类型安全性和稳健的错误处理
连接到您的AI助手
将MCP Context Server连接到Claude Code的最快方法是使用Docker bootstrap命令。
有关分步说明、先决条件、故障排除和更新/卸载命令,请参阅 连接到您的AI助手指南.
环境配置
服务器通过环境变量完全配置,支持核心设置、传输、身份验证、嵌入提供程序、摘要生成、搜索功能、数据库调优等。变量可以在MCP客户端配置中设置 .env 文件,或直接在shell中。
有关所有具有类型、默认值、约束和描述的环境变量的完整参考,请参阅 环境变量参考.
摘要生成
摘要生成会自动为每个存储的上下文条目创建基于LLM的简明摘要。摘要将返回到 summary 所有搜索工具结果旁边的截断字段 text_content,提供密集、信息丰富的摘要,帮助代理在不获取完整条目的情况下确定相关性。
有关包括所有提供者(Ollama、OpenAI、Anthropic)、模型选择和自定义提示配置的详细说明,请参阅 摘要生成指南.
语义搜索
有关使用多个嵌入提供程序(Ollama、OpenAI、Azure、HuggingFace、Voyage)启用可选语义搜索的详细说明,请参阅 语义搜索指南.
全文检索
有关使用语言处理、词干、排名和布尔查询的全文搜索,请参阅 全文搜索指南.
混合搜索
关于使用交互秩融合(RRF)的FTS+语义搜索的组合,请参阅 混合搜索指南.
元数据过滤
有关包括16个运算符、嵌套JSON路径和性能优化的全面元数据过滤,请参阅 元数据指南.
数据库后端
服务器支持多个数据库后端,可通过 STORAGE_BACKEND 环境变量。SQLite(默认)提供零配置本地存储,非常适合单用户部署。PostgreSQL为多用户和高流量部署提供了10倍以上的写入吞吐量的高性能功能。
有关详细的配置说明,包括PostgreSQL与Docker的设置、Supabase集成、连接方法和故障排除,请参阅 数据库后端指南.
API 参考
MCP上下文服务器公开了13个用于上下文管理的MCP工具:
核心业务: store_context, search_context, get_context_by_ids, delete_context, update_context, list_threads, get_statistics
搜索工具: semantic_search_context, fts_search_context, hybrid_search_context
批量操作: store_context_batch, update_context_batch, delete_context_batch
有关包括参数、返回值、筛选选项和示例在内的完整工具文档,请参阅 API 参考.
Docker部署
对于具有HTTP传输和容器编排的生产部署,Docker Compose配置可用于SQLite、PostgreSQL和外部PostgreSQL(Supabase)。请参阅 有关设置说明和客户端连接详细信息。
Kubernetes部署
对于Kubernetes部署,Helm chart提供了不同环境的可配置值。请参阅 Helm部署指南 有关安装说明,或 Kubernetes部署指南 了解Kubernetes的一般概念。
认证
对于需要身份验证的HTTP传输部署,请参阅 身份验证指南 用于承载令牌配置。
