article
README
🚀 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 集成
配置步骤
- 打开 Claude Desktop 的设置界面(菜单栏 → 设置 → 开发者 → 编辑配置)。
- 在
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文件的绝对路径。最后一个参数是允许访问的目标目录(可添加多个目录,用逗号分隔)。
💡 使用建议
为了提升服务器的安全性,默认情况下启用了中文内容过滤模块。
- 重启 Claude Desktop 以使配置生效。
功能说明
安全机制
- 仅限访问预先授权的目录。
- 解析符号链接以防止绕过安全检查。
- 验证所有请求路径的有效性。
- 默认启用只读模式,防止未经授权的文件修改。
核心功能
- 文件信息查询。
- 目录结构浏览。
- 内置中文语言支持。
- 多线程处理能力。
操作指南
启动服务器
uv run mcp --directory /path/to/your/directory
访问服务器
通过 Claude Desktop 的 MCP 服务管理器连接到指定的服务器实例。
使用工具
在 Claude 的控制台中输入相应的命令,调用服务器提供的功能模块。
常见问题解答
- 服务器未在 Claude 中显示:
- 确认 UV 是否正确安装并添加到 PATH。
- 检查配置文件中的路径是否正确。
- 访问被拒绝:
- 确保尝试访问的目录属于允许列表中。
- Claude 无法找到工具:
- 修改配置后请重启 Claude Desktop。
📄 许可证
文档中未提及许可证相关信息。
微信扫一扫