AI导哈

上下文解析引擎服务

mcp-context-server 是一个通过模型上下文协议（MCP）为AI代理提供确定性上下文解析引擎的服务，支持从本地文档中检索可重现且可审计的上下文。

  • by contextenginehq
  • Rust
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 contextenginehq/context-mcp-server

使用说明

mcp上下文服务器

mcp-context-server 通过模型上下文协议（MCP）将确定性上下文解析引擎暴露给AI代理。它使代理能够从本地文档中检索可复制、可审计的选定上下文，而不依赖于网络。

mcp-context-server 是Context平台上代理的主要集成界面。

建筑

MCP服务器是确定性上下文引擎上的瘦协议适配器。

代理→ MCP客户端→ mcp上下文服务器→ 上下文核心→ 上下文缓存

  • context-core 执行确定性选择
  • 服务器提供稳定的JSON-RPC接口
  • 无需网络呼叫或外部服务
  • 专为内部和空气间隙环境而设计

创建缓存

缓存是使用 context CLI：

context build --sources ./docs --cache ./caches/my-cache

看 context-cli 存储库以获取详细信息。

工具

工具 说明
context.resolve 使用查询和令牌预算从缓存中解析上下文
context.list_caches 列出服务器缓存根下的可用上下文缓存
context.inspect_cache 检查缓存元数据和有效性

配置

服务器是通过环境变量配置的：

变量 必填 默认 描述
CONTEXT_CACHE_ROOT yes -- 包含上下文缓存的根目录
CONTEXT_TOOL_TIMEOUT_SECS 否 30 每次工具调用的最长秒数

跑步

CONTEXT_CACHE_ROOT=./caches ./dist/mcp-context-server

服务器从stdin读取JSON-RPC请求，并将响应写入stdout。它被设计为由MCP客户端（例如，代理框架Claude Desktop）启动。

MCP客户端配置

对于Claude Desktop，请在MCP配置中添加：

{
  "mcpServers": {
    "context": {
      "command": "/path/to/mcp-context-server",
      "env": {
        "CONTEXT_CACHE_ROOT": "/path/to/your/caches"
      }
    }
  }
}

协议

  • 传输：stdio（JSON-RPC 2.0，换行符分隔）
  • 协议版本： 2024-11-05
  • 所有响应都是确定性的
  • 错误代码： cache_missing, cache_invalid, invalid_query, invalid_budget, io_error, internal_error

决定论保证

对于相同的输入（缓存内容、查询和预算），服务器保证：

  • 字节相同的响应
  • 稳定的文档订购
  • 稳定的浮点表示
  • 请求之间没有隐藏状态

决定论是通过跨版本和平台的兼容性测试工具来实施的。

失败语义

  • 工具错误返回结构化MCP错误响应
  • 服务器从不因用户输入错误而恐慌
  • IO故障报告为 io_error
  • 无效缓存报告为 cache_invalid

构建

make build     # debug build
make test      # run all tests (31 tests including 11 golden snapshot tests)
make check     # cargo check + clippy
make release   # optimized build, binary copied to dist/
make clean     # remove artifacts

发布二进制文件名为 mcp-context-server 并放置在 dist/.

规范参考

看 spec_refs.md 获取管理规范的链接。

“上下文引擎”是上下文引擎贡献者的商标。该软件是开源的 Apache许可证2.0未经事先书面许可，该商标不得被第三方用于营销竞争产品或服务。

相关 MCP