关键词

个人知识库RAGLLM工具Cloudflare WorkersOAuth认证

项目简介

Kollektiv MCP 是一个基于 Cloudflare Workers 构建的 MCP 服务器实现，旨在为各种 LLM 客户端（如 Cursor, Windsurf, Claude Desktop, VS Code 等）提供个人知识库服务。通过实现 Model Context Protocol (MCP)，它允许 LLM 客户端访问用户上传的文档，并利用服务器端工具进行查询和检索。该项目集成了 OAuth 认证流程，确保数据和服务的安全性。

主要功能点

  • 文档查询 ('/query_documents'): 允许 LLM 对用户上传的文档进行语义搜索和问答，基于用户上传的文档内容提供答案。
  • 文档列表 ('/list_documents'): 返回用户已同步到 Kollektiv 的文档列表及其基本信息。
  • OAuth 2.1 认证: 提供安全的授权流程，LLM 客户端需通过网页完成认证后才能访问服务器能力。
  • 多传输协议支持: 通过 'mcp-remote' 工具支持标准的 JSON-RPC over HTTP 和 Server-Sent Events (SSE) 等协议。
  • Cloudflare Workers 部署: 利用 Cloudflare 的边缘计算能力实现高性能和可扩展性。

安装步骤

该项目是为部署在 Cloudflare Workers 平台而设计的。作为终端用户，你通常不需要自己安装部署此服务器代码，而是直接使用其已部署的公共服务。

如果你是开发者或想自托管，需要克隆仓库，配置 Cloudflare Workers 项目环境（包括绑定 KV 存储、Supabase 集成、可能还有 AI/Vectorize 绑定），然后使用 Wrangler CLI 进行构建和部署。详细的自托管步骤通常在项目的代码和文档中查找。

服务器配置 (为 MCP 客户端使用)

MCP 客户端需要通过配置 JSON 文件（通常是 'mcp.json'）来连接到 Kollektiv MCP 服务器。以下是典型的客户端配置示例说明，你可以将此信息添加到你的 MCP 客户端配置中：

  • 配置示例说明:

    {
  "mcpServers": {
    "kollektiv": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.thekollektiv.ai/mcp"
      ]
    }
  }
}
    • 'kollektiv': 服务器的自定义名称，你可以为这个 MCP 服务器在客户端中指定一个易于识别的名称。
    • 'command': 启动连接程序的命令，'npx' 用于执行 Node.js 包。确保你的系统安装了 Node.js。
    • 'args': 传递给 'command' 的参数列表。
      • '-y': 自动确认安装所需的 'mcp-remote' 包。
      • 'mcp-remote': MCP 官方提供的远程连接工具，用于通过 HTTP/SSE 连接到远程 MCP 服务器。
      • 'https://mcp.thekollektiv.ai/mcp': Kollektiv MCP 服务器的实际端点 URL，这是客户端通过 'mcp-remote' 工具连接到的地址。

    请参考你使用的 MCP 客户端的具体文档，了解如何添加或编辑 MCP 服务器配置。添加配置并重启客户端后，如果需要认证，通常会弹出一个网页窗口引导你完成登录和授权流程。

基本使用方法

连接成功并通过认证后，在支持 MCP 的 LLM 客户端中，你就可以开始使用 Kollektiv MCP 提供的工具了。通常，你需要在与 LLM 交互时，显式地引导其使用特定的工具。根据项目文档，一个有效的方法是在你的提示中包含短语 "use Kollektiv MCP"，以指示客户端调用 Kollektiv MCP 上的工具。

例如，你可以这样提问来查询你的文档： "use Kollektiv MCP, What are the key features of the Model Context Protocol?"

要查看你上传的文档列表，你可以尝试： "use Kollektiv MCP, list my documents."

请注意，文档上传后通常需要一段时间进行处理（例如 1-2 分钟）才能被查询。

信息

分类

AI与计算

访问项目