项目简介

DevContext 是一个创新的上下文协议 (MCP) 服务器,旨在优化开发工作流。它能够从您的开发模式中持续学习,适应您的需求,并提供高度相关的项目上下文信息,帮助您更深入地理解代码库,并简化任务管理。它通过标准化方式向大型语言模型 (LLM) 客户端提供上下文信息和功能。

主要功能点

  • 持续学习与项目感知: 随着项目的演进不断学习,提供越来越相关的上下文。
  • 深度代码理解: 洞察代码库,发现传统工具可能遗漏的信息。
  • 智能任务管理: 通过智能功能简化和优化开发任务流程。
  • 会话上下文管理: 维护和更新 LLM 客户端与服务器之间的交互会话上下文,支持复杂、多轮的开发任务。
  • 资源托管与数据访问: 托管和管理代码实体、文件结构、项目模式、会话历史等资源,并提供灵活的数据访问能力。
  • 工具注册与执行: 注册并提供一系列外部功能工具,使 LLM 能够调用它们来执行代码分析、上下文更新、里程碑记录等操作。
  • 事件时间线与快照: 记录重要的开发事件,并创建上下文快照,便于回溯和学习。
  • 模式识别与推广: 识别和学习项目中的常见模式,并可将其推广为全局模式以提高复用性。

安装步骤

  1. 克隆 DevContext 仓库:
    git clone https://github.com/Rathesh2727/devcontext.git
  2. 进入项目目录:
    cd devcontext
  3. 安装项目依赖:
    npm install

服务器配置

DevContext MCP 服务器通过 'Stdio' 协议通信,LLM 客户端需要配置服务器的启动命令。 您需要确保本地环境中已安装 Node.js 和 npm。

以下是配置 MCP 客户端连接 DevContext 服务器的示例信息(请根据您的实际环境调整):

{
  "server_name": "DevContext",
  "command": "npm",
  "args": ["start"],
  "env": {
    "TURSO_DATABASE_URL": "您的Turso数据库URL,例如:libsql://...",
    "TURSO_AUTH_TOKEN": "您的Turso数据库认证Token",
    "LOG_LEVEL": "INFO" // 可选,控制日志级别:DEBUG, INFO, WARN, ERROR
  },
  "description": "DevContext MCP 服务器,提供项目上下文感知和开发工具集。"
}

重要提示: 'TURSO_DATABASE_URL' 和 'TURSO_AUTH_TOKEN' 是运行服务器所必需的数据库凭证。请在服务器启动前将其设置为环境变量,或在上述 'env' 字段中提供。

基本使用方法

  1. 启动服务器: 安装完成后,通过以下命令启动 DevContext 服务器:

    npm start

    服务器将在后台运行,并等待 MCP 客户端通过标准输入/输出 (Stdio) 进行通信。

  2. 通过 MCP 客户端交互: 您可以使用任何兼容 MCP 协议的客户端(例如一个 LLM 代理)来连接此服务器。客户端将通过 JSON-RPC 调用服务器上注册的工具,例如:

    • 'initialize_conversation_context': 初始化新的会话上下文。
    • 'update_conversation_context': 更新会话并处理代码变更或新消息。
    • 'retrieve_relevant_context': 查询和获取与当前任务相关的上下文信息。
    • 'record_milestone_context': 记录开发里程碑。
    • 'finalize_conversation_context': 结束会话并提取学习成果。

    这些工具将帮助您的 LLM 客户端管理和利用项目的开发上下文。

信息

分类

开发者工具