LPS MCP - Claude 工具服务器

项目概述

LPS MCP 是一个功能精简的服务器，旨在为 Claude 提供高级工具，使其能够安全访问文件系统并具备逻辑推理能力。该服务器是 LPS 基础设施的一部分，用于增强人工智能助手在工作环境中的能力。

主要特点

• 安全文件系统访问：支持文件导航和只读功能，并设有严格的访问限制
• 逻辑推理工具：能够将复杂问题分解为结构化的思考步骤
• 可配置设置：用户可以自定义允许访问的目录

系统要求

• Python 3.10 或更高版本
• 已安装 UV（Python 包管理器）并添加到系统 PATH 中
• 安装最新版 Claude Desktop

安装指南

1. 安装 UV（如未安装）：

   # 适用于 Windows（PowerShell）：
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   
   # 适用于 macOS/Linux：
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. 验证 UV 是否安装：

   uv --version
   

3. 克隆或下载本仓库：

   git clone https://github.com/lpsDevelopers/LPS-MCP
   cd mcp-lps
   

4. 安装依赖项：

   uv pip install "mcp[cli]"
   

配置与 Claude Desktop 集成

1. 打开 Claude Desktop 的设置界面（菜单栏 → 设置 → 开发者 → 编辑配置）

2. 在 claude_desktop_config.json 文件中添加以下内容：

   {
     "mcpServers": {
       "lps-mcp": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/LPS-MCP",
           "run",
           "server.py",
           "path/to/directory"
         ]
       }
     }
   }
   

   注意：请将 path/to/LPS-MCP 替换为您实际存储 server.py 文件的绝对路径。最后一个参数是允许访问的目标目录（可添加多个目录，用逗号分隔）。

   语言支持提示：为了提升服务器的安全性，默认情况下启用了中文内容过滤模块。

3. 重启 Claude Desktop 以使配置生效

功能说明

• 安全机制：

  • 仅限访问预先授权的目录
  • 解析符号链接以防止绕过安全检查
  • 验证所有请求路径的有效性
  • 默认启用只读模式，防止未经授权的文件修改

• 核心功能：

  • 文件信息查询
  • 目录结构浏览
  • 内置中文语言支持
  • 多线程处理能力

操作指南

1. 启动服务器：

   uv run mcp --directory /path/to/your/directory
   

2. 访问服务器：

   • 通过 Claude Desktop 的 MCP 服务管理器连接到指定的服务器实例。

3. 使用工具：

   • 在 Claude 的控制台中输入相应的命令，调用服务器提供的功能模块。

常见问题解答

• 服务器未在 Claude 中显示：

  • 确认 UV 是否正确安装并添加到 PATH
  • 检查配置文件中的路径是否正确

• 访问被拒绝：

  • 确保尝试访问的目录属于允许列表中

• Claude 无法找到工具：

  • 修改配置后请重启 Claude Desktop

LPS