Kollektiv MCP

🚀 Kollektiv MCP 项目

Kollektiv MCP 是一个运行在 Cloudflare Workers 上的远程模型上下文协议（MCP）服务器。它允许用户借助 IDE（像 Cursor、Windsurf、Claude Desktop 这类与 MCP 兼容的客户端），在自己的文档上运用 RAG（Retrieval-Augmented Generation）技术。

⚠️ 重要提示

该 MCP 服务器目前仍处于开发阶段，尚未准备好用于生产环境。

🚀 快速开始

安装依赖

使用 npm 或 yarn 安装项目所需的依赖：

npm install
# 或者
yarn install

启动服务器

在安装完依赖后，启动 MCP 服务器：

npm run dev
# 或者
yarn dev

接口定义

MCP 服务器提供以下关键接口：

• DocumentAnalyzer：用于分析和处理文档内容。
• Configurator：负责配置和管理服务器参数。

✨ 主要特性

Kollektiv MCP 服务器由以下几个关键组件组成：

• OAuth 提供程序 (workers-oauth-provider 和 supabase)：负责处理身份验证和授权。
• 类型定义 (types)：确保代码的强类型安全性和一致性。
• 核心业务逻辑 (src/main.ts)：实现 MCP 协议的具体功能，如文档分析和数据检索。

📦 安装指南

连接 MCP 服务器

要在项目中连接到 MCP 服务器，您可以按照以下步骤操作：

1. 安装客户端库：

   npm install @kollektiv/mcp-client
   # 或者
   yarn add @kollektiv/mcp-client
   

2. 配置连接参数： 更新项目的环境变量（.env）文件，添加以下内容：

   MCP_ENDPOINT=http://localhost:8000
   

3. 使用客户端： 在代码中引入并初始化 MCP 客户端：

   import { KollektivMCP } from '@kollektiv/mcp-client';
   
   const mcp = new KollektivMCP({
     endpoint: process.env.MCP_ENDPOINT,
   });
   
   // 示例调用
   await mcp.analyzeDocument('your_document_content');
   

🔧 技术细节

依赖管理

项目使用 tsconfig.json 和 package.json 来管理 TypeScript 配置和依赖项。我们推荐使用以下工具进行开发：

• 代码编辑器：VS Code
• 构建工具：npm scripts 或 yarn

项目结构

kollektiv-mcp/
├── types/          # 类型定义
├── src/
│   ├── main.ts    # 核心业务逻辑
└── public/        # 静态资源

📄 许可证

该库根据 Apache License 2.0 发布。如需商业支持或其他许可方式，请联系：azuev@outlook.com

💡 使用建议

• 身份验证：所有外部 API 调度必须通过 OAuth 进行身份验证。
• 数据隔离：确保每个用户的文档处理是相互隔离的，防止数据泄露。