MCP Servers 项目简介
本仓库 'mcp-servers' 旨在提供一组基于 Model Context Protocol (MCP) 的服务器实现,用于增强大型语言模型 (LLM) 应用的功能。目前包含两个主要服务器:增强会话管理器 和 任务管理服务器。这些服务器可以作为独立的后端服务,通过 MCP 协议与 LLM 客户端进行通信,为 LLM 应用提供结构化的上下文信息和任务执行能力。
主要功能点:
- 增强会话管理器:
- 提供高级会话管理功能,支持会话快照 (Checkpoints) 和回滚 (Rollbacks),方便用户管理和恢复会话状态。
- 具备会话索引和搜索能力,便于快速查找和访问特定会话。
- 跟踪会话变更历史,记录会话数据的修改,提供审计和回溯功能。
- 任务管理服务器:
- 支持项目和任务跟踪,帮助用户组织和管理复杂的任务流程。
- 提供组件管理功能,方便对任务组成部分进行维护和更新。
- 具备进度监控能力,实时展示任务执行状态,方便用户掌握项目进展。
- 数据存储:
- 使用 SQLite 数据库进行数据存储,轻量级且易于部署。
- 具备高效索引和数据版本控制能力,保证数据访问效率和数据一致性。
安装步骤:
- 环境准备: 确保已安装 Node.js 和 npm (Node 包管理器)。
- 下载项目: 从 GitHub 仓库 https://github.com/kayi2215/mcp-servers 下载或克隆代码。
- 安装依赖: 在项目根目录下打开终端,运行 'npm install' 命令安装项目依赖。
服务器配置:
- 创建配置文件: 在项目根目录下创建 '.env' 文件。
- 配置数据库路径: 在 '.env' 文件中设置 'DB_PATH' 环境变量,指定 SQLite 数据库文件的存储路径,例如 'DB_PATH=./data/sessions.db'。
- 配置日志级别: 在 '.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': 启动命令的参数,指定任务管理服务器的入口文件路径。
基本使用方法:
-
启动服务器:
- 打开终端,进入项目根目录。
- 运行 'node servers/session-manager/index.js' 命令启动增强会话管理器。
- 或运行 'node servers/task-manager/index.js' 命令启动任务管理服务器。
- 服务器启动后,将监听 MCP 客户端的请求。
-
配置 MCP 客户端:
- 根据您的 MCP 客户端软件的文档,配置服务器连接信息,使用上面提供的 JSON 配置示例。
- 确保客户端能够通过 MCP 协议与服务器建立连接。
-
使用 MCP 客户端功能:
- 连接成功后,即可在 MCP 客户端中使用会话管理或任务管理相关的功能,例如创建会话、保存会话快照、创建任务、查看任务进度等。
- 具体功能和操作方式请参考您的 MCP 客户端软件的使用说明。
信息
分类
开发者工具