STARWARCLOUD STARWAR.AI
返回市场
集体-MCP

集体-MCP

作者：alexander-zuev61 星标更新：2025-10-21
安装使用来源：spider==github.com

项目介绍

技术文档摘要

⚠️ 已废弃 - Kollektiv MCP

🚨 重要提示：此实验性的MCP服务器现已废弃，并将在不久后关闭。

如需更新，请访问 kollektiv.sh

请勿在新项目中使用此服务器。

TypeScript Runtime Auth Supabase Build codecov License

🧠 个人LLM知识库 (已废弃)

[原始描述 - 不再维护] Kollektiv MCP 可以让你在几秒钟内建立个人LLM知识库，并从你最喜欢的编辑器或客户端使用它。无需设置基础设施、分块或同步——只需上传你的数据并开始聊天。开箱即支持所有主要的MCP客户端——Cursor、Windsurf、Claude Desktop等。

⚠️ 废弃通知

此实验性的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
  • 参数:
    • -y - 此选项允许shell安装mcp-remote，这是目前连接远程服务器所必需的
    • mcp-remote - 此选项允许客户端连接到远程MCP服务器（在这种情况下是Kollektiv）
    • https://mcp.thekollektiv.ai/mcp - 是你要连接的端点

请参阅下面的简短演示或阅读特定于客户端的说明，了解如何连接。

连接演示

Cursor

打开Cursor并进入Cursor 设置 > MCP > 添加新的全局MCP服务器。粘贴上述配置并保存（Ctrl/Cmd+S）。

Cursor 配置

如果配置成功且之前未进行身份验证，浏览器窗口会引导你到登录页面。

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

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

成功连接到Cursor

Windsurf

打开Windsurf并进入设置 -> Windsurf 设置 > MCP服务器 > 查看原始配置。粘贴上述配置并保存（Ctrl/Cmd+S）。

Windsurf MCP配置

如果配置成功且之前未进行身份验证，浏览器窗口会引导你到登录页面。

💡 根据我的经验，与其他客户端相比，Windsurf需要重启应用程序才能正确连接。如果服务器在一段时间后仍未变为绿色，请尝试采取下面的故障排除步骤。

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

成功配置Windsurf

Claude for Desktop

打开Claude Desktop并进入设置 -> 开发者 > 编辑配置。在任何文本/代码编辑器中打开json文件，粘贴上述配置并保存（Ctrl/Cmd+S）。

Claude Desktop配置

如果配置成功且之前未进行身份验证，浏览器窗口会引导你到登录页面。

💡 Claude for Desktop需要重启应用程序才能正确连接。如果服务器在一段时间后仍未变为绿色，请尝试采取下面的故障排除步骤。

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

成功连接到Claude for Desktop

VS Code

打开VS Code并进入设置 -> MCP: 添加服务器 > 命令（标准输入输出）：

  • 命令:
    • 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"
        ]
      }
    }
  }
}

VS Code配置

下一步：

  • 点击开始以连接到MCP服务器
    • 如果你尚未认证，将被引导至认证页面
  • 记得在settings.json中添加"chat.mcp.enabled": true,
  • 切换到代理模式

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

如果连接成功，你应该能看到由Kollektiv MCP提供的工具。

成功连接到VS Code

Cline

打开Cline，点击MCP服务器 > 编辑配置，并在你的cline_mcp_settings.json中添加以下配置：

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

注意：Cline目前还不支持直接连接到支持授权的远程服务器。

如果连接成功，你会经历认证流程。登录后，你应该能在Cline中看到启用的Kollektiv MCP。

Cline配置

其他（PyCharm、Claude Code）

大多数MCP客户端遵循相同的.json格式，并且应该可以通过类似的配置步骤进行连接：

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

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

  • 客户端开发者对MCP连接的支持程度
  • 客户端是否支持最新的MCP规范，包括Oauth支持

如果你遇到问题，通过这些简单的故障排除步骤可能会有所帮助。

支持的客户端

我已经验证了以下MCP客户端可以连接：

  • Cursor ✅
  • Windsurf ✅
  • Claude Desktop ✅
  • VS Code ✅
  • Cline ✅

理论上其他MCP客户端也应该支持，但在实践中可能会有所不同。如果你有特别想连接的客户端，请告诉我！

🎮 使用方法

可用工具

  • /query_documents — 向你上传到Kollektiv的文档提交一个问题，并基于文档中的来源获得答案。
  • /list_documents — 返回已同步文档的列表及其基本元数据。
  • 小贴士： 包含短语**“使用Kollektiv MCP”**，以便客户端知道调用这些工具。

使用技巧

  • 始终添加“使用Kollektiv MCP” — 这告诉客户端要使用哪个MCP服务器。
  • 等待文档变为可用状态 — 上传后，需要1-2分钟文档才能被查询。
  • 必要时重新表述查询 — 如果客户端生成的查询不佳，自行编辑或重写。

❓ 故障排除与支持

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

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

如果你遇到连接问题，请按照以下故障排除步骤操作，这应该可以帮助你连接到MCP服务器。

支持

如果你需要额外支持，请在GitHub上创建问题或联系support@thekollektiv.ai

连接故障排除

如果你收到无效授权请求错误如下所示，或者由于其他原因无法连接，请尝试按照以下步骤操作，这应该可以解决问题。

授权错误

  1. 确保你连接到了正确的端点：

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

  2. 清除mcp-remote缓存：

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

# Windows
Remove-Item -Recurse -Force "$env:USERPROFILE\.mcp-auth"
  1. 清除浏览器数据及cookies：
    • 这会做什么：
      • 移除存储登录Kollektiv时使用的认证信息的浏览器cookies。
    • 如何操作：
      • 打开浏览器设置并删除最近几个小时的浏览数据

⚠️ 注意：这将使你从所有活动会话中登出，包括Kollektiv。只有在卡在了破损的登录流程中时才执行此操作。

  1. 重启你的MCP客户端并尝试重新连接到MCP服务器：
    • 这会做什么：
      • MCP客户端（如Cursor、Windsurf等）通常会缓存之前的连接/配置设置，这可能会干扰认证。
    • 如何操作：
      • 重启你的编辑器/客户端
      • 尝试重新连接到MCP服务器

使用MCP Inspector

为了调试目的，你可以使用MCP Inspector连接到Kollektiv MCP服务器。

npx @modelcontextprotocol/inspector

选择SSE或Streamable HTTP传输

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

🛠️ 实现细节（针对🤓）

如果你只是来了解Kollektiv的，请跳过这一节。这一节是为好奇其工作原理的开发者和构建者准备的。

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

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

  • MCP服务器（Cloudflare Worker） https://mcp.thekollektiv.ai 作为客户端通过Model Context Protocol与索引数据交互的安全网关。支持OAuth。

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

  • 后端（FastAPI） https://api.thekollektiv.ai 负责源数据的摄入、验证以及RAG管道的编排。

🔐 安全

Kollektiv MCP实施了几项安全措施：

  • 登录通过Supabase支持的标准OAuth 2.1“授权码”流进行；仅存储短暂的、HttpOnly、Secure的cookies——服务器永远不会接触到密码。

  • 所有流量均通过Cloudflare边缘独家通过HTTPS提供，每个敏感的POST请求都会携带一次性CSRF/事务令牌。

  • 后端运行在Cloudflare Workers沙盒中（没有本地文件系统，没有长时间运行的进程），大大减少了攻击面。

    有关详细披露指南，请参见SECURITY.md。

🪪 许可证

根据Apache许可证2.0发布——商业支持或替代许可请联系azuev@outlook.com