使用说明

项目简介

Spidy 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在扩展大型语言模型 (LLM) 的能力。它提供网页抓取和简单的笔记存储功能，使 LLM 能够访问和利用外部信息。Spidy 作为一个 MCP 服务器，可以与兼容 MCP 协议的 LLM 客户端（例如 Claude）集成，为其提供上下文信息和功能。

主要功能点

资源管理 (Resources)：
- 实现了简单的笔记存储系统。
- 每个笔记都作为资源通过自定义的 'note://' URI 方案访问。
- 支持创建、存储和读取文本格式的笔记。
Prompt 模板 (Prompts)：
- 提供 'summarize-notes' Prompt，用于总结所有已存储的笔记。
- 允许通过可选的 'style' 参数（'brief' 或 'detailed'）控制摘要的详细程度。
工具 (Tools)：
- 提供 'web-crawl' 工具，用于抓取指定 URL 的网页内容。
- 抓取结果可以保存到服务器本地的文件中。

安装步骤

Spidy 服务器本身是一个 Python 项目，根据仓库 'README.md' 中的开发指南，可以使用 'uv' 进行依赖管理和构建。但对于最终用户，更重要的是如何配置 MCP 客户端（如 Claude）来连接和使用 Spidy 服务器。 通常情况下，你无需手动安装 Spidy 服务器代码。 Claude 等 MCP 客户端会负责启动和管理 MCP 服务器进程。你需要做的主要是配置客户端，告知其 Spidy 服务器的启动方式。

服务器配置 (MCP 客户端配置)

要将 Spidy 服务器配置到 MCP 客户端（例如 Claude Desktop），你需要编辑客户端的配置文件。以 Claude Desktop 为例，配置文件路径如下：

MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

在配置文件中，找到 '"mcpServers"' 部分，并添加 Spidy 服务器的配置信息。以下是 Spidy 服务器的配置示例：

"mcpServers": {
  "mcp-server-spidy": {
    "command": "uvx",
    "args": [
      "mcp-server-spidy"
    ]
  }
}

配置参数说明：

'server name': '"mcp-server-spidy"' - 服务器的名称，用于在客户端中标识和引用。可以自定义，但需要与客户端配置中使用的名称一致。
'command': '"uvx"' - 启动服务器的命令。 'uvx' 很可能是项目使用的包管理工具 'uv' 提供的执行器，用于在项目环境中运行脚本。 假设 Claude 客户端能够识别并执行 'uvx' 命令，并能正确找到和运行 'mcp-server-spidy' 脚本。实际部署时，可能需要根据服务器的部署环境和启动脚本的具体位置进行调整。例如，如果 'uvx' 不可用，可能需要替换为 'python -m mcp_server_spidy.server' 或其他合适的命令。
'args': '["mcp-server-spidy"]' - 传递给启动命令的参数。 '"mcp-server-spidy"' 很可能是指示 'uvx' 运行的脚本或模块名称。同样，具体参数可能需要根据实际情况调整。

基本使用方法

配置完成后，MCP 客户端（如 Claude）应该能够连接到 Spidy 服务器。你可以通过客户端的界面或指令来调用 Spidy 服务器提供的功能：

使用 'summarize-notes' Prompt: 在客户端中，你可以选择或调用 'summarize-notes' Prompt，让 LLM 总结 Spidy 服务器中存储的笔记。你可以根据需要选择 "brief" (简要) 或 "detailed" (详细) 风格的摘要。
使用 'web-crawl' 工具: 在需要抓取网页时，可以调用 'web-crawl' 工具。你需要提供以下参数：
- 'url': 要抓取的网页 URL 地址。
- 'output_file': 抓取结果保存的文件名 (保存在 Spidy 服务器运行的本地文件系统中)。

注意: Spidy 服务器的功能依赖于服务器端的运行环境。网页抓取工具的执行结果（保存的文件）也会存储在服务器端的文件系统中，而不是客户端。

关键词

使用说明

信息