LPS MCP

🚀 LPS MCP - Claude 工具服务器

LPS MCP 是一款功能精简的服务器，主要为 Claude 提供高级工具。它能让 Claude 安全访问文件系统，还赋予其逻辑推理能力，是 LPS 基础设施的一部分，有助于增强人工智能助手在工作环境中的能力。

🚀 快速开始

LPS MCP 服务器旨在为 Claude 提供高级工具，增强其在文件系统访问和逻辑推理方面的能力。您可按以下步骤完成安装和配置，开启使用之旅。

✨ 主要特性

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

📦 安装指南

安装 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

验证 UV 是否安装

uv --version

克隆或下载本仓库

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

安装依赖项

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 以使配置生效。

功能说明

安全机制

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

核心功能

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

操作指南

启动服务器

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

访问服务器

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

使用工具

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

常见问题解答

• 服务器未在 Claude 中显示：
  • 确认 UV 是否正确安装并添加到 PATH。
  • 检查配置文件中的路径是否正确。
• 访问被拒绝：
  • 确保尝试访问的目录属于允许列表中。
• Claude 无法找到工具：
  • 修改配置后请重启 Claude Desktop。

📄 许可证

文档中未提及许可证相关信息。