a

alexander-zuev

@alexander-zuev/kollektiv-mcp
0 Stars 322 次浏览 alexander-zuev 更新于 2026-08-23
知识管理与记忆

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

服务介绍

Kollektiv MCP

TypeScript
Runtime
Auth Supabase
Build
codecov
License

🧠 你的个人LLM知识库

Kollektiv MCP使你能够在几秒钟内构建个人LLM知识库，并从你喜欢的编辑器/客户端中使用它。无需再进行基础设施设置、分块、同步——只需上传你的数据并开始聊天。开箱即用支持所有主要的MCP客户端——Cursor、Windsurf、Claude Desktop等。

🧪 Kollektiv正处于早期测试阶段。如果你在连接到MCP客户端时遇到任何问题，请先尝试按照这些步骤操作。如果仍然不成功，请在此处提出问题。

为什么选择Kollektiv？

  • 无需在聊天会话之间重新上传数据
  • 可以从任何客户端访问 - Cursor、Windsurf、Claude Desktop、VSCode、PyCharm等
  • 无需基础设施设置 - 只需上传你的数据即可开始聊天

💿 连接

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

json
{
"mcpServers": {
"kollektiv": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.thekollektiv.ai/mcp"
]
}
}
}

  • name:
    • kollektiv - 你可以给服务器起任何描述性的名称
  • command:
    • npx - 确保在运行此命令之前已安装node.js
  • args:
    • -y - 这允许你的shell安装mcp-remote，这是目前连接到远程服务器所必需的
    • mcp-remote - 这使你的客户端能够连接到远程MCP服务器（在这种情况下是Kollektiv）
    • https://mcp.thekollektiv.ai/mcp - 是你要连接的端点

查看下面的简短演示或阅读特定于客户端的连接说明。

连接演示

Cursor

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

Cursor配置

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

💡 保存json后，Cursor可能需要一段时间才能连接到MCP。你可能需要重启Cursor或稍等片刻。如果你看到“Client is closed”或其他错误，采取这些故障排除步骤可能会有所帮助。

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

成功的Cursor连接

Windsurf

打开Windsurf并转到Settings -> Windsurf Settings > MCP Servers > View raw config。粘贴上述配置并保存（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: 添加服务器 > 命令 (stdio):

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

您的 settings.json 配置应类似于以下内容：

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 添加以下配置：

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连接的意愿有多强
  • 客户端是否支持带有OAuth支持的最新MCP规范

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

支持的客户端

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

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

理论上其他MCP客户端也应被支持，但实际上情况可能有所不同。如果您有特别想要连接的客户端，请告诉我！

🎮 使用方法

可用工具

  • /query_documents — 向您上传到Kollektiv的文档提交一个问题，并根据您的文档来源接收答案。
  • /list_documents — 返回您同步的文档列表以及基本元数据。
  • 专业提示： 包含短语**“use Kollektiv MCP”**，这样客户端就知道调用这些工具。

使用技巧

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

❓ 故障排除与支持

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

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

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

支持

如果您需要额外的支持，请在GitHub上创建一个issue或通过support@thekollektiv.ai联系我们。

连接故障排除

如果您收到如下所示的无效授权请求错误或因其他原因无法连接，请尝试执行以下步骤，这应该可以解决问题。

授权错误

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

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

  2. 清理 mcp-remote 缓存：

    • 功能说明：
      • 清除用于从不支持远程连接的客户端连接到远程服务器的mcp-remote库缓存。
    • 操作方法：
      • 在终端中运行以下命令

bash

MacOS

rm -rf ~/.mcp-auth

Windows

Remove-Item -Recurse -Force "$env:USERPROFILE.mcp-auth"

  1. 清除浏览器数据和cookies：
    • 功能说明：
      • 清除登录Kollektiv时用来存储认证信息的浏览器cookie。
    • 操作方法：
      • 打开浏览器设置并删除最近几小时的浏览数据

⚠️ 注意：这将使您从所有活动会话（包括Kollektiv）中注销。只有当您卡在一个损坏的登录流程中时才这样做。

  1. 重启您的MCP客户端并尝试重新连接到MCP服务器：
    • 功能说明：
      • MCP客户端（如Cursor、Windsurf等）通常会缓存之前的运行中的连接/配置设置，这可能会干扰认证过程。
    • 操作方法：
      • 重启您的编辑器/客户端
      • 尝试重新连接到MCP服务器

使用MCP检查器

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

bash
npx @modelcontextprotocol/inspector

选择SSE或可流式传输的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 的 Cookie——密码永远不会接触到此服务器。

  • 所有流量都通过 Cloudflare 的边缘节点 仅通过 HTTPS 传输，并且每个敏感的 POST 请求都携带一次性 CSRF/事务令牌。

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

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

🪪 许可证

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

查看源码 项目主页

相关 MCP 服务

Markmap思维导图
jinzcdev/Markmap
Markmap MCP 服务器基于模型上下文协议（MCP），允许一键将 Markdown 文本转换为交互式思维导图，支持多种格式导出和丰富的交互操作。它基于开源项目 markmap 构建。
LeetCode(力扣)
jinzcdev/leetcode-mcp-server
MCP 服务器实现 LeetCode API 集成，支持自动化获取编程题库、用户数据和竞赛信息。
Github的维基百科DeepWiKi
@regenrek/mcp-deepwiki
📖 MCP 服务器用于获取 deepwiki.com 的最新知识，并在 Cursor 和其他代码编辑器中使用
微信读书
@package/mcp-server-weread
一个为微信读书提供MCP（Model Context Protocol）服务的工具，支持将微信读书的书籍、笔记和划线数据提供给支持MCP的大语言模型客户端，如Claude Desktop。