项目简介

OpenContext 解决了AI助手使用中的一个痛点:在不同会话和项目之间,上下文信息容易丢失。它作为一个轻量级的个人知识存储系统,让AI助手能够"先加载历史,再执行操作;完成后,持久化保存"。

主要功能

  • 文档管理:创建、编辑、移动和删除文档与文件夹
  • 智能搜索:支持关键词搜索、向量搜索和混合搜索
  • 稳定引用:提供 'oc://doc/<稳定ID>' 格式的稳定链接
  • MCP服务器:通过标准输入输出协议为IDE和智能体平台提供工具调用接口
  • 跨项目复用:全局上下文库,默认存储在 '~/.opencontext/contexts'
  • 多端同步:支持CLI、桌面应用和Web UI
  • 集成支持:自动生成Cursor等IDE的配置文件和命令模板

安装步骤

  1. 安装CLI工具

    npm install -g @aicontextlab/cli
  2. 初始化环境: 在需要集成的项目目录中运行:

    oc init

服务器配置

OpenContext的MCP服务器通过 'oc mcp' 命令启动,使用stdio传输协议。主要配置参数包括:

  • 服务器名称:'opencontext'
  • 启动命令:'oc'
  • 参数:'mcp'

配置示例

{
  "mcpServers": {
    "opencontext": {
      "command": "oc",
      "args": ["mcp"]
   }

## 基本使用方法

1. **在Cursor中使用**:
   - 运行 'oc init' 后,即可在Cursor中使用 '/opencontext-*' 系列命令

2. **手动启动MCP服务器**:
   ```bash
   oc mcp
  1. 常用命令
    • '/opencontext-context':加载背景信息
    • '/opencontext-search':搜索相关文档
    • '/opencontext-create':创建新文档
    • '/opencontext-iterate':保存学习成果和决策

搜索功能

  • 关键词搜索:无需API密钥,直接基于文本匹配
  • 向量搜索:需要配置嵌入API密钥,提供语义搜索能力
  • 混合搜索:结合关键词和向量搜索的优势

注意:向量搜索需要先配置嵌入API并构建索引:

oc config set EMBEDDING_API_KEY "你的密钥"
oc index build

信息

分类

开发者工具