使用说明

项目简介

LSD MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在使 Claude 等大型语言模型能够通过 LSD SQL 语言与互联网进行交互。它允许 Claude 执行 LSD SQL 查询来抓取、分析和操作网页数据，从而扩展了 LLM 的能力边界，使其能够访问和利用实时的网络信息。

主要功能点

LSD SQL 执行: 提供 'run_lsd' 工具，允许 Claude 执行 LSD SQL 查询，从网页中提取结构化数据。
结果可视化: 提供 'view_lsd' 工具，返回一个 URL，用户可以通过该链接在 LSD 平台查看 LSD SQL 查询结果和执行过程的可视化回放。
文档资源: 提供 'lsd://docs' 资源， Claude 可以访问 LSD SQL 的文档，以便更好地理解和使用 LSD SQL 语言。
Prompt 模板:
- 'write_lsd_sql': 生成用于编写 LSD SQL 查询的 Prompt，帮助 Claude 构造有效的查询语句。
- 'write_and_run_lsd_sql': 在 'write_lsd_sql' 的基础上，指示 Claude 在生成 LSD SQL 后立即执行并展示结果。

安装步骤

克隆仓库

git clone https://github.com/lsd-so/lsd-mcp.git
cd lsd-mcp

配置环境变量

复制仓库中的 '.env.example' 文件并重命名为 '.env'，然后根据您的 LSD 账户信息修改 '.env' 文件中的 'LSD_USER' (您的注册邮箱) 和 'LSD_API_KEY' (API 密钥)。

LSD_USER=<your_email_here>
LSD_API_KEY=<api_key_from_your_profile_page>

安装 MCP 服务器

确保您已安装 Python 和 uv。然后运行以下命令安装 LSD MCP Server：
```
uv run mcp install app.py
```

服务器配置

要将 LSD MCP Server 集成到 MCP 客户端（例如 Claude 桌面应用），您需要配置客户端的 MCP 服务器设置。以下是一个 'claude_desktop_config.json' 文件的配置示例。

注意: 'claude_desktop_config.json' 文件通常位于 '~/Library/Application Support/Claude/' (macOS) 或 '%APPDATA%\Claude' (Windows) 目录下。如果文件不存在，请根据 MCP 官方文档创建。

{
  "mcpServers": {
    "LSD": {
      "command": "/path/to/your/uv",  //  请替换为 uv 的完整路径，可以使用 'which uv' 命令查找
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "psycopg2-binary",
        "mcp",
        "run",
        "/path/to/your/lsd-mcp/app.py" // 请替换为 lsd-mcp 仓库中 app.py 文件的完整路径
      ]
    }
  }
}

配置说明:

'"LSD"': 服务器名称，在 Claude 中用于识别和调用 LSD MCP Server。
'"command"': 启动 MCP 服务器的命令。这里是 'uv' 的完整路径。您可以使用 'which uv' 命令在终端中查找 'uv' 的安装路径并替换 '/path/to/your/uv'。
'"args"': 传递给 'uv' 命令的参数列表。
- '"run"': 'uv run' 命令用于运行 Python 脚本。
- '"--with", "mcp[cli]"': 指定运行环境包含 'mcp[cli]' 依赖，这是 MCP 命令行工具和库。
- '"--with", "psycopg2-binary"': 指定运行环境包含 'psycopg2-binary' 依赖，这是 Python PostgreSQL 客户端库，LSD MCP Server 使用它来连接 LSD SQL 数据库。
- '"mcp"': 调用 'mcp' 命令，表示要运行 MCP 服务器。
- '"run"': 'mcp run' 子命令用于启动 MCP 服务器。
- '"/path/to/your/lsd-mcp/app.py"': 指定要运行的 Python 脚本，即 LSD MCP Server 的主程序 'app.py' 的完整路径。请将 '/path/to/your/lsd-mcp/app.py' 替换为您本地 'lsd-mcp' 仓库中 'app.py' 文件的实际路径。

完成配置后，重启您的 MCP 客户端（如 Claude 桌面应用）。

基本使用方法

在 Claude 中，您可以使用以下方式来调用 LSD MCP Server 的功能：

使用 Prompt 模板引导 Claude 生成和执行 LSD SQL:

您可以使用自定义 Prompt，例如：

请使用 LSD SQL 编写查询来... (你的目标)

或者使用更明确的指令，例如：

使用 LSD 工具，根据以下目标编写 LSD SQL 查询并运行: (你的目标)

您也可以参考仓库 README 中提供的 Prompt 示例，利用 'write_lsd_sql' 或 'write_and_run_lsd_sql' Prompt 模板来辅助 Claude 生成 LSD SQL 查询。

Claude 调用 Tools 和 Resources:

一旦服务器配置正确，Claude 应该能够自动发现并调用 LSD MCP Server 提供的 'run_lsd', 'view_lsd' 工具和 'lsd://docs' 资源，从而实现与 Web 数据的交互。

例如，您可以要求 Claude:
```
使用 LSD SQL 查询 GitHub Trending 仓库。
```
Claude 可能会自动调用 'run_lsd' 工具来执行 LSD SQL 查询，并使用 'view_lsd' 工具返回可视化结果链接。

注意: 首次在 Claude 会话中使用 LSD 功能时，可能需要使用包含 LSD SQL 文档的自定义 Prompt 来引导 Claude，如 README 中 "Claude on LSD" 部分所述。

关键词