AI导哈

LLM知识库服务

Kollektiv MCP是一个已弃用的实验性服务，用于快速构建个人LLM知识库，支持多种MCP客户端连接。

  • by alexander-zuev
  • TypeScript
  • 本地部署
  • 61 星标
  • 更新于
在 GitHub 查看 alexander-zuev/kollektiv-mcp

使用说明

⚠️ 失望-集体MCP

🚨 重要提示：此实验性MCP服务器现已停用，将很快关闭。

如需更新，请访问 kollektiv.sh

请不要将此服务器用于新项目。

🧠 您的个人法学硕士知识库（已停用）

[原始描述-不再保留] Kollektiv MCP使您能够在几秒钟内建立个人法学硕士知识库，并从您的 最喜欢的编辑/客户。无需更多的基础设施设置、分块、同步-只需上传您的 数据并开始聊天。支持所有主要的MCP客户端-Cursor、Windsurf、， 克劳德桌面等。

⚠️ 弃用通知

这个实验性的MCP服务器是 已弃用 并将 很快关闭。服务端点可能随时停止工作，恕不另行通知。

请勿将其用于新项目或生产用途。

💿 连接（已停用-可能无法工作）

连接到Kollektiv MCP的最简单方法是复制并粘贴以下内容 配置到编辑器中 mcp.json 文件。所有客户端（Cursor、Windsurf、Claude Desktop、， VSCode、PyCharm）支持此功能 json 格式

{
  "mcpServers": {
    "kollektiv": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.thekollektiv.ai/mcp"
      ]
    }
  }
}
  • 姓名：
    • kollektiv-你能给服务器起一个描述性的名字吗
  • 命令：
    • npx -在运行此命令之前，请确保已安装node.js
  • args：
    • -y -这使您的shell能够安装 mcp-remote 当前需要连接 到远程服务器
    • mcp-remote -这使您的客户端能够连接到远程MCP服务器（在本例中 集体）
    • https://mcp.thekollektiv.ai/mcp -是您要连接的端点

查看下面的简短演示，或阅读有关如何连接的客户端特定说明。

光标

打开光标并转到 Cursor Settings > MCP > Add new global MCP Server.粘贴配置 上面并保存（ctrl/cmd+s）。

如果配置成功，并且您之前没有进行过身份验证，则浏览器窗口应该 打开，引导您进入登录页面。

💡保存后 json Cursor可能需要一段时间才能连接到MCP。你可以 需要重新启动Cursor或给它一点时间。如果您看到“客户端已关闭”或其他错误， 拿着这些 故障排除 步骤可能会有所帮助。

如果连接成功，您应该看到Kollektiv MCP在设置页面中变为绿色：

帆板运动

打开Windsurf，前往 Settings -> Windsurf Settings > MCP Servers > View raw config. 粘贴上面的配置并保存（ctrl/cmd+s）。

如果配置成功，并且您之前没有进行过身份验证，则浏览器窗口应该 打开，引导您进入登录页面。

💡与其他客户不同，根据我的经验，Windsurf需要重新启动应用程序 正确连接。如果服务器在一段时间后没有变为“绿色”，请尝试检查 故障排除 步骤如下。

如果连接成功，您应该在设置页面中看到Kollektiv MCP变绿：

Claude桌面版

打开克劳德桌面并转到 Settings -> Developer > Edit config.打开 json 文件在任何 文本/代码编辑器，粘贴上面的配置并保存（ctrl/cmd+s）。

如果配置成功，并且您之前没有进行过身份验证，则浏览器窗口应该 打开，引导您进入登录页面。

💡Claude for Desktop需要重新启动应用程序才能正确连接。如果服务器不运行 “绿色”过了一段时间，试着过一遍 故障排除 步骤如下。

如果连接成功，您应该在设置页面中看到Kollektiv MCP变绿：

VS Code

打开VS Code并转到 Settings -> MCP: Add server > Command (stdio):

  • 命令：
    • npx -y mcp-remote https://mcp.thekollektiv.ai/mcp
  • 姓名：
    • 为您的服务器提供一个描述性名称，例如 kollektiv

您的配置 settings.json 应该看起来像这样：

{
  "chat.mcp.discovery.enabled": true,
  "chat.mcp.enabled": true,
  "mcp": {
    "servers": {
      "kollektiv": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.thekollektiv.ai/mcp"
        ]
      }
    }
  }
}

下一步：

  • 点击 开始 连接到MCP服务器
    • 如果您未通过身份验证，您将被带到身份验证页面
  • 记得添加 "chat.mcp.enabled": true, 在你的 settings.json
  • 切换到 代理 模式

💡VS Code要求您手动 开始 您的服务器，添加 chat.mcp.enabled 并切换到 使用MCP的代理模式。如果在代理模式下看不到MCP工具，请尝试查看 故障排除 步骤如下。

如果连接成功，您应该看到Kollektiv MCP公开的工具。

克莱恩

打开Cline，点击 MCP Servers > Edit Configuration 并将以下配置添加到您的 cline_mcp_settings.json:

{
  "mcpServers": {
    "kollektiv": {
      "timeout": 60,
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.thekollektiv.ai/mcp"
      ],
      "transportType": "stdio",
      "disabled": false
    }
  }
}

注意：尚不支持直接连接到支持授权的远程服务器 克莱恩。

如果连接成功，您将进入身份验证流程。测井后 在中，您应该看到在Cline中启用了Kollektiv MCP。

其他（PyCharm、克劳德密码）

大多数MCP客户端都遵循相同的规则 .json 格式，并应与类似的配置步骤配合使用 正如前面提到的客户：

  1. 将配置复制并粘贴到客户端 json 配置
  2. 重新启动应用程序
  3. 如果尚未进行身份验证，请进行身份验证
  4. Kollektiv MCP应变为绿色，并可在聊天/代理模式下使用

您的连接成功取决于许多因素，包括但不限于：

  • 特定客户端的强大开发人员希望支持MCP连接的程度
  • 客户端是否支持 最新的 MCP规范 支持Oauth

如果您遇到问题，请通过以下步骤 简单 故障排除步骤 可能会有所帮助。

支持的客户

我已经验证了与以下MCP客户端的连接是否正常：

  • 光标✅
  • 帆板运动✅
  • 克劳德桌面版✅
  • VS Code✅
  • 克莱恩✅

其他MCP客户端 应该 理论上是支持的，但在实践中可能会有点支持 不同。如果你有一个你真的想联系的客户，请告诉我！

🎮 用法

可用工具

  • /query_documents --向您上传到Kollektiv的文件提交问题 根据您的文档来源收到答案。
  • /list_documents --返回已同步文档的列表以及基本元数据。
  • 专业提示： 包含短语 集体 MCP 因此客户端知道调用这些工具。

使用技巧

  • 始终添加“使用Kollektiv MCP” -这个命令会告诉客户端要使用哪个MCP服务器。
  • 等待文档可用 --上传后，文件需要1-2分钟才能上传 被质疑。
  • 必要时重新表述查询 --如果客户端生成的查询质量不佳，请对其进行编辑或重写 你自己。

❓ 故障排除和支持

此MCP服务器使用Cloudflare代理SDK以及其他库来提供最现代化的 用户连接和使用MCP服务器的方式。另一方面，MCP客户端尚未 实施对2个关键部分的支持：

  • 远程MCP服务器
  • MCP服务器授权

如果您遇到连接问题，请执行以下故障排除步骤 这应该有助于您连接到MCP服务器。

支持

如果您需要额外的支持，请打开GitHub问题或联系support@thekollektiv.ai

连接故障排除

如果你得到 授权请求无效 错误如下或无法连接 另一个原因是，请尝试执行以下步骤，这些步骤应该可以解决问题。

  1. 确保连接到正确的端点:

    • 使用 https://mcp.thekollektiv.ai/mcp 作为MCP终点。

  2. 清理mcp远程缓存:

    • 这有什么作用：
      • 删除缓存 mcp-remote 用于从连接到远程服务器的库 不支持远程连接的客户端
    • 怎样：
      • 在终端中运行以下命令
# MacOS
rm -rf ~/.mcp-auth  

# Windows
Remove-Item -Recurse -Force "$env:USERPROFILE\.mcp-auth"
  1. 清除浏览器数据和Cookie:
    • 这有什么作用：
      • 删除登录时用于存储身份验证信息的浏览器Cookie 进入集体。
    • 怎样：
      • 打开浏览器设置，删除过去几个小时的浏览数据

⚠️ 注意：这将使您退出所有活动会话，包括Kollektiv。只有在以下情况下才能这样做 您陷入了登录流程中断的困境。

  1. 重新启动MCP客户端并尝试重新连接到MCP服务器：
    • 这有什么作用：
      • MCP客户端（Cursor、Windsurf等）通常缓存来自以下位置的连接/配置设置 之前的运行可能会干扰身份验证。
    • 怎样：
      • 重新启动编辑器/客户端
      • 尝试重新连接到MCP服务器

使用MCP检查器

出于调试目的，您可以使用MCP检查器连接到Kollektiv MCP服务器。

npx @modelcontextprotocol/inspector

选择SSE或流式HTTP传输

  • SSE：连接到服务器 https://mcp.thekollektiv.ai/sse
  • 流式HTTP：连接到服务器 https://mcp.thekollektiv.ai/mcp

🛠️ 实施细节（适用于🤓)

如果你只是为了Kollektiv而来，跳过这个。本节适合好奇的开发人员和构建人员 关于它是如何工作的。

Kollektiv MCP是模块化系统的一部分，使用户能够在其数据上设置RAG 几秒钟内，无需管理基础设施、管道或模型配置。

它由三个独立部署的服务组成：

  • MCP服务器（Cloudflare Worker）
    https://mcp.thekollektiv.ai
    充当客户端通过模型上下文与索引数据交互的安全网关 协议。支持OAuth。

  • 前端（React+Vite Worker）
    https://thekollektiv.ai
    一个干净、简洁的用户界面，用于上传和管理他们的内容。

  • 后端（FastAPI）
    https://api.thekollektiv.ai
    处理RAG管道的源摄取、验证和编排。

🔐 安全

Kollektiv MCP实施了多种安全措施：

  • 通过标准登录 OAuth 2.1“授权码”流程 由Supabase提供动力；仅 短暂的， HttpOnly, Secure Cookie被存储起来——任何密码都不会接触到这台服务器。

  • 所有交通都得到了服务 通过Cloudflare的边缘仅通过HTTPS，每一个敏感 POST请求携带一次性CSRF/交易令牌。

  • 后端在内部运行 Cloudflare Workers沙盒 （无本地文件系统，无长时间运行 过程），大大减少了攻击面。

    有关详细的披露指南，请参阅 安全.md.

🪪 许可证

根据Apache License 2.0发布——商业支持或替代许可： azuev@outlook.com

相关 MCP