项目简介
Survey-ZI-UIN-New 是一个现代化的全栈Web应用,旨在通过模型上下文协议 (MCP) 集成AI功能。该项目包含用于AI集成的MCP服务器,例如文件系统服务器和内存服务器,为LLM客户端提供资源访问和上下文管理能力。
主要功能点
- 文件系统服务器: 允许LLM客户端通过MCP协议访问和操作服务器本地文件系统中的文件资源。
- 内存服务器: 提供基于内存的持久化存储,用于在LLM对话会话中维护和管理上下文数据。
- RESTful API 后端: 使用Express构建的后端服务,提供标准的REST API,支持前端应用的数据交互和管理。
- 现代Web技术栈: 采用React 18, TypeScript, Tailwind CSS, Vite, Drizzle ORM等先进技术,保证应用性能和开发效率。
安装步骤
-
安装依赖: 在项目根目录下,打开终端并运行 'npm install' 命令,安装项目所需的所有依赖包。
-
启动开发服务器: 安装完成后,运行 'npm run dev' 命令,启动前端和后端的开发服务器。
-
构建生产版本: 当需要部署生产环境时,运行 'npm run build' 命令,构建优化后的生产版本应用。
-
启动生产服务器: 构建完成后,运行 'npm start' 命令,启动生产环境的服务器。
服务器配置 (MCP 客户端配置)
要连接到 Survey-ZI-UIN-New 提供的MCP服务器,您需要在MCP客户端中进行如下配置。以下配置信息描述了如何连接到文件系统服务器和内存服务器。
[ { "serverName": "FileSystemServer", "command": "start_mcp_filesystem.bat", "args": [], "description": "文件系统 MCP 服务器启动命令 (请确保 MCP 服务器脚本位于 mcp-servers 目录下)" }, { "serverName": "MemoryServer", "command": "start_mcp_memory.bat", "args": [], "description": "内存 MCP 服务器启动命令 (请确保 MCP 服务器脚本位于 mcp-servers 目录下)" }, { "serverName": "AllMCPServers", "command": "start_all_mcp_servers.bat", "args": [], "description": "启动所有 MCP 服务器的命令 (请确保 MCP 服务器脚本位于 mcp-servers 目录下)" } ]
配置说明:
- 'serverName': MCP 服务器的名称,客户端用于标识和管理不同的服务器连接。
- 'command': 启动 MCP 服务器的可执行命令或脚本。这里指向了仓库中提供的 '.bat' 批处理文件,用于快速启动服务器。请注意,实际部署时,您可能需要根据您的操作系统和环境,将 '.bat' 文件替换为相应的启动命令,例如Shell脚本或直接的Node.js命令。
- 'args': 传递给启动命令的参数,当前配置为空数组,表示没有额外的启动参数。如有需要,您可以在此处添加参数。
- 'description': 对该服务器配置的简要描述,方便用户理解其用途。
重要提示: 上述配置中的 'command' 假设 MCP 服务器脚本(如 '.bat' 文件)位于 'mcp-servers' 目录下,并且客户端能够执行这些脚本。您需要确保MCP客户端能够正确执行这些命令以启动MCP服务器进程。
基本使用方法
- 启动 MCP 服务器: 根据您的需求,导航到 'mcp-servers' 目录,运行 'start_mcp_filesystem.bat'、'start_mcp_memory.bat' 或 'start_all_mcp_servers.bat' 脚本来启动所需类型的 MCP 服务器。
- 配置 MCP 客户端: 在您的 MCP 客户端应用中,根据上述 "服务器配置" 部分的 JSON 示例,配置服务器连接信息。确保客户端能够根据配置的 'command' 启动并连接到 MCP 服务器。
- 使用 AI 功能: 一旦客户端成功连接到 MCP 服务器,您的 AI 应用即可利用 MCP 协议提供的文件系统和内存资源,实现更丰富的上下文交互和功能扩展。例如,LLM可以读取文件内容作为知识来源,或将对话上下文存储在内存服务器中以便后续使用。
信息
分类
数据库与文件