MCP Servers 项目简介

本仓库 'mcp-servers' 旨在提供一组基于 Model Context Protocol (MCP) 的服务器实现,用于增强大型语言模型 (LLM) 应用的功能。目前包含两个主要服务器:增强会话管理器任务管理服务器。这些服务器可以作为独立的后端服务,通过 MCP 协议与 LLM 客户端进行通信,为 LLM 应用提供结构化的上下文信息和任务执行能力。

主要功能点:

  • 增强会话管理器:
    • 提供高级会话管理功能,支持会话快照 (Checkpoints) 和回滚 (Rollbacks),方便用户管理和恢复会话状态。
    • 具备会话索引和搜索能力,便于快速查找和访问特定会话。
    • 跟踪会话变更历史,记录会话数据的修改,提供审计和回溯功能。
  • 任务管理服务器:
    • 支持项目和任务跟踪,帮助用户组织和管理复杂的任务流程。
    • 提供组件管理功能,方便对任务组成部分进行维护和更新。
    • 具备进度监控能力,实时展示任务执行状态,方便用户掌握项目进展。
  • 数据存储:
    • 使用 SQLite 数据库进行数据存储,轻量级且易于部署。
    • 具备高效索引和数据版本控制能力,保证数据访问效率和数据一致性。

安装步骤:

  1. 环境准备: 确保已安装 Node.js 和 npm (Node 包管理器)。
  2. 下载项目: 从 GitHub 仓库 https://github.com/kayi2215/mcp-servers 下载或克隆代码。
  3. 安装依赖: 在项目根目录下打开终端,运行 'npm install' 命令安装项目依赖。

服务器配置:

  1. 创建配置文件: 在项目根目录下创建 '.env' 文件。
  2. 配置数据库路径: 在 '.env' 文件中设置 'DB_PATH' 环境变量,指定 SQLite 数据库文件的存储路径,例如 'DB_PATH=./data/sessions.db'。
  3. 配置日志级别: 在 '.env' 文件中设置 'LOG_LEVEL' 环境变量,指定日志输出级别,例如 'LOG_LEVEL=info' (可选,默认为 info)。

MCP 客户端配置示例 (JSON):

以下 JSON 配置信息可用于 MCP 客户端连接到本仓库提供的服务器。请根据您需要使用的服务器选择相应的配置,并将其添加到您的 MCP 客户端配置中。

  • 增强会话管理器 配置:
{
  "serverName": "EnhancedSessionManager",
  "command": "node",
  "args": ["servers/session-manager/index.js"]
}
* 'serverName':  服务器名称,用于在客户端标识和管理连接。
* 'command': 启动服务器的命令,这里使用 'node' 运行 JavaScript 文件。
* 'args':  启动命令的参数,指定会话管理服务器的入口文件路径。
  • 任务管理服务器 配置:
{
  "serverName": "TaskManagerServer",
  "command": "node",
  "args": ["servers/task-manager/index.js"]
}
* 'serverName': 服务器名称,用于在客户端标识和管理连接。
* 'command': 启动服务器的命令,这里使用 'node' 运行 JavaScript 文件。
* 'args': 启动命令的参数,指定任务管理服务器的入口文件路径。

基本使用方法:

  1. 启动服务器:

    • 打开终端,进入项目根目录。
    • 运行 'node servers/session-manager/index.js' 命令启动增强会话管理器。
    • 或运行 'node servers/task-manager/index.js' 命令启动任务管理服务器。
    • 服务器启动后,将监听 MCP 客户端的请求。
  2. 配置 MCP 客户端:

    • 根据您的 MCP 客户端软件的文档,配置服务器连接信息,使用上面提供的 JSON 配置示例。
    • 确保客户端能够通过 MCP 协议与服务器建立连接。
  3. 使用 MCP 客户端功能:

    • 连接成功后,即可在 MCP 客户端中使用会话管理或任务管理相关的功能,例如创建会话、保存会话快照、创建任务、查看任务进度等。
    • 具体功能和操作方式请参考您的 MCP 客户端软件的使用说明。

信息

分类

开发者工具