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