serkan-ozal-driflyte-mcp-server

Driflyte MCP 服务

适用于 Driflyte 的 MCP 服务。

Driflyte MCP 服务提供了一些工具，使 AI 助手能够从递归爬取和索引的网页中查询并检索特定主题的知识。 借助此 MCP 服务，Driflyte 可充当多种主题相关内容源（网页、GitHub 等）与 AI 推理之间的桥梁，从而提供更丰富、更准确的回答。

功能

• 深度网页爬取：递归跟踪链接，爬取并索引网页。
• GitHub 集成：爬取代码仓库、问题和讨论。
• 可扩展的资源支持：计划在未来支持 Slack、Microsoft Teams、Google Docs/Drive、Confluence、JIRA、Zendesk、Salesforce 等。
• 主题感知索引：每份文档都会标记一个或多个主题，从而支持有针对性的主题专属检索。
• 以 RAG 为 RAG 而设计：该服务本身以检索增强生成（RAG）为设计理念，并通过向助手提供高质量、特定主题的文档作为依据上下文，为 RAG 工作流提供支持。
• 以 AI 为 AI 而设计：该系统不仅面向 AI 助手，也通过 AI 本身进行设计和迭代，使其成为用于智能知识检索的原生 AI 组件。

使用与限制

• 免费使用：Driflyte 目前可免费使用。
• 无需注册：您可以立即开始使用，无需注册或订阅。
• 速率限制：为确保公平使用，请求按 IP 地址限制：
  • 每个 IP 地址 每 5 分钟最多 100 次 API 请求。
• 随着新功能和资源集成的推出，使用政策和限制未来可能会有所调整。

前置条件

• Node.js 18+
• AI 助手（带有 MCP 客户端），例如 Cursor、Claude（Desktop 或 Code）、VS Code、Windsurf 等……

配置

CLI 参数

Driflyte MCP 服务支持以下 CLI 参数进行配置：

• --transport <stdio|streamable-http> - 配置传输协议（默认为 stdio）。
• --port <number> – 使用 streamable-http 传输时配置监听端口号（默认为 3000）。

快速开始

此 MCP 服务（使用 STDIO 或 Streamable HTTP 传输）可通过 @driflyte/mcp-server NPM 包添加到任何 MCP 客户端， 例如 VS Code、Claude、Cursor、Windsurf Github Copilot。

ChatGPT

• 前往个人资料下的 Settings，并在 Connectors 选项下启用 Developer Mode。
• 在聊天面板中，点击 + 图标，然后从下拉菜单中选择 Developer Mode。 您会看到添加来源/连接器的选项。
• 输入以下 MCP 服务详情，然后点击 Create：
  • Name：Driflyte
  • MCP Server URL：https://mcp.driflyte.com/openai
  • Authentication：No authentication
  • Trust Setting：勾选 I trust this application

有关更多信息，请参阅如何设置远程 MCP 服务并将其连接到 ChatGPT 深度研究 和 ChatGPT 中现已提供 MCP 服务工具——开发者模式。

Claude Code

运行以下命令。 有关更多信息，请参阅 Claude Code MCP 文档。

本地服务

claude mcp add driflyte -- npx -y @driflye/mcp-server

远程服务

claude mcp add --transport http driflyte https://mcp.driflyte.com/mcp

Claude Desktop

本地服务

将以下配置添加到 claude_desktop_config.json 文件中。 更多信息请参阅 Claude Desktop MCP 文档。

{
  "mcpServers": {
    "driflyte": {
      "command": "npx",
      "args": ["-y", "@driflyte/mcp-server"]
    }
  }
}

远程服务

在 Claude Desktop 中前往 Settings > Connectors > Add Custom Connector，并使用以下字段添加新的 MCP 服务：

• 名称：Driflyte
• 远程 MCP 服务 URL：https://mcp.driflyte.com/mcp

Copilot 编码 Agent

通过 Repository > Settings > Copilot > Coding agent > MCP configuration，将以下配置添加到 Copilot 编码 Agent 配置的 mcpServers 部分。 更多信息请参阅 Copilot 编码 Agent MCP 文档。

本地服务

{
  "mcpServers": {
    "driflyte": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@driflyte/mcp-server"]
    }
  }
}

远程服务

{
  "mcpServers": {
    "driflyte": {
      "type": "http",
      "url": "https://mcp.driflyte.com/mcp"
    }
  }
}

Cursor

将以下配置添加到 ~/.cursor/mcp.json 文件中（或项目文件夹中的 .cursor/mcp.json）。 也可以通过 🖱️一键安装 进行设置。 更多信息请参阅 Cursor MCP 文档。

本地服务

{
  "mcpServers": {
    "driflyte": {
      "command": "npx",
      "args": ["-y", "@driflyte/mcp-server"]
    }
  }
}

远程服务

{
  "mcpServers": {
    "driflyte": {
      "url": "https://mcp.driflyte.com/mcp"
    }
  }
}

Gemini CLI

将以下配置添加到 ~/.gemini/settings.json 文件中。 更多信息请参阅 Gemini CLI MCP 文档。

本地服务

{
  "mcpServers": {
    "driflyte": {
      "command": "npx",
      "args": ["-y", "@driflyte/mcp-server"]
    }
  }
}

远程服务

{
  "mcpServers": {
    "driflyte": {
      "httpUrl": "https://mcp.driflyte.com/mcp"
    }
  }
}

Smithery

运行以下命令。 你可以在此处找到你的 Smithery API 密钥。 更多信息请参阅 Smithery CLI 文档。

npx -y @smithery/cli install @serkan-ozal/driflyte-mcp-server --client <SMITHERY-CLIENT-NAME> --key <SMITHERY-API-KEY>

VS Code

将以下配置添加到 .vscode/mcp.json 文件中。 也可以通过 🖱️一键安装 进行设置。 更多信息请参阅 VS Code MCP 文档。

本地服务

{
  "mcp": {
    "servers": {
      "driflyte": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@driflyte/mcp-server"]
      }
    }
  }
}

远程服务

{
  "mcp": {
    "servers": {
      "driflyte": {
        "type": "http",
        "url": "https://mcp.driflyte.com/mcp"
      }
    }
  }
}

Windsurf

将以下配置添加到 ~/.codeium/windsurf/mcp_config.json 文件中。 更多信息请参阅 Windsurf MCP 文档。

本地服务

{
  "mcpServers": {
    "driflyte": {
      "command": "npx",
      "args": ["-y", "@driflyte/mcp-server"]
    }
  }
}

远程服务

{
  "mcpServers": {
    "driflyte": {
      "serverUrl": "https://mcp.driflyte.com/mcp"
    }
  }
}

组件

工具

• list-topics：返回已抓取资源（网页等）且内容可用的主题列表。 这有助于 AI 助手发现爬虫当前索引中最相关且最新的主题领域。
  • 输入架构：不支持输入参数。
  • 输出架构：
    • topics：
      • Optinal：false
      • Type：Array<string>
      • Description：支持的主题列表。
• search：给定主题列表和用户问题后，此工具会从抓取的内容中检索最相关的前 K 篇文档。 它旨在帮助 AI 助手针对特定主题和查询，找到语境最合适且最新的信息。 这样便能基于真实世界中按主题标记的网络内容，提供更有依据且准确的回答。
  • 输入架构：
    • topics
      • Optinal：false
      • Type：Array<string>
      • Description：用于限定搜索范围的一个或多个主题标识符列表。 仅考虑至少带有其中一个主题标签的文档。
    • query
      • Optinal：false
      • Type：string
      • Description：要查找相关信息的自然语言查询或问题。 此内容将用于按语义相关性对文档排序。
    • topK
      • Optinal：true
      • Type：number
      • Default Value：10
      • Min Value：1
      • Max Value：30
      • Description：要返回的相关文档的最大数量。 结果按相关性得分降序排列。
  • 输出架构：
    • documents：
      • Optional：false
      • Type：Array<Document>
      • Description：与搜索查询匹配的文档。
      • Type：Document：
        • content
          • Optinal：false
          • Type：string
          • Description：匹配文档的相关内容（全部或部分）。
        • metadata
          • Optinal：false
          • Type：Map<string, any>
          • Description：以键值格式表示的文档及相关内容的元数据。
        • score
          • Optinal：false
          • Type：number
          • Min Value：0
          • Max Value：1
          • Description：文档内容的相似度得分（介于 0 和 1 之间）。

资源

不适用

路线图

• 支持更多内容类型（.pdf、.ppt/.pptx、.doc/.docx 以及许多其他适用类型，包括音频和视频文件格式……）
• 集成更多数据源（Slack、Teams、Google Docs/Drive、Confluence、JIRA、Zendesk、Salesforce 等）
• 增加更多主题及其资源

问题与反馈

如需报告错误、请求功能或寻求支持，请使用 GitHub Issues。

贡献

如果您想要参与贡献，请：

• 在 GitHub 上 Fork 此仓库并克隆您的 Fork。
• 为您的更改创建一个分支，并在该分支上进行修改。
• 提交拉取请求，清楚说明您的贡献。

提示： 请检查现有拉取请求中是否有类似贡献，并考虑先提交一个 issue 讨论拟议的功能，再编写代码。

许可证

根据 MIT 许可。