LPS MCP - Claude 工具服务器

概述

LPS MCP 是一个功能最简化的服务器，旨在为 Claude 提供高级工具，从而安全地访问文件系统和进行顺序思考。该服务器是 LPS 基础设施的一部分，用于增强 AI 助手在工作环境中的能力。

特性

• 安全的文件系统访问：具有安全限制的文件导航和只读功能
• 顺序思考工具：能够将复杂问题分解为结构化的思考步骤
• 可定制的配置：控制哪些目录可以访问

前提条件

• 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 是否在 PATH 中:

   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 的配置 (Claude 菜单 → 设置 → 开发者 → 编辑配置)

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 所在的目录的绝对路径。 最后一个参数是允许访问的目录（可以使用逗号分隔添加多个目录）。

   语言: 要使用带有西班牙语描述的工具，请选择 server_es.py

3. 重启 Claude Desktop 以加载新配置。

可用工具

文件系统工具

• read_file: 读取文件的内容
• read_multiple_files: 同时读取多个文件
• list_directory: 显示某个位置的文件和目录
• directory_tree: 以 JSON 格式显示目录结构
• search_files_tool: 按名称搜索文件
• get_file_info: 显示文件元数据
• list_allowed_directories: 列出允许的目录

顺序思考工具

• sequentialthinking: 允许 Claude 将复杂问题分解为结构化的思考步骤，具有以下能力：
  • 遵循逻辑思维顺序
  • 回顾之前的想法
  • 创建分支以探索不同的方法
  • 动态调整所需的步骤数

用法

配置完成后，您可以要求 Claude 执行以下操作：

1. 读取 允许位置的文件：

   • “你能读取文件 [路径] 吗？”
   • “显示 [路径] 的内容”

2. 浏览目录：

   • “在 [目录] 中有什么文件？”
   • “显示 [目录] 中的文件结构”

3. 使用顺序思考：

   • “逐步分析以下问题：[问题]”
   • “使用顺序思考制定 [任务] 的计划”

4. 组合工具:

   • 一旦 Claude 通过读取信息了解了项目的结构，您可以要求它使用顺序思考来尝试推导与代码相关的复杂问题的解决方案。

安全性

此服务器实施严格的安全措施：

• 仅限访问明确允许的目录
• 解析符号链接以防止安全绕过
• 验证所有请求的路径
• 只读模式以防止未经授权的修改

故障排除

• 服务器未出现在 Claude 中：确保 UV 已正确安装并在 PATH 中，并且配置文件中的路径正确。
• 访问被拒绝错误：验证您是否尝试访问允许路径内的目录。
• Claude 找不到工具：修改配置后重新启动 Claude Desktop。

---

LPS