项目简介

Graphlit MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,它桥接了 MCP 客户端和 Graphlit 平台。通过此服务器,LLM 客户端可以利用 Graphlit 平台的强大功能,实现对多数据源内容的访问和管理,从而增强 LLM 应用的上下文理解和功能扩展。

主要功能点

  • 知识检索: 提供强大的知识检索工具,允许 LLM 客户端根据自然语言prompt,从 Graphlit 知识库中检索相关内容源。
  • 数据提取: 支持从文本中提取结构化 JSON 数据,方便 LLM 对非结构化信息的理解和利用。
  • 数据摄取: 集成多种数据连接器,支持从如 Slack, Discord, 网站, Google Drive, Linear, GitHub 等多平台摄取数据到 Graphlit 知识库。
  • 内容和集合管理: 提供创建、删除和管理内容集合的功能,方便用户组织和利用知识。
  • 异步任务管理: 支持内容和数据源的异步摄取任务,并提供查询任务状态的工具。
  • 丰富的工具集: 除了核心的检索和提取工具外,还提供了网页爬取、网页截图、图片描述等多种实用工具,扩展了 LLM 的应用场景。
  • 资源管理: 定义了内容 (Contents)、数据源 (Feeds) 和内容集合 (Collections) 三种核心资源,方便 LLM 客户端进行访问和管理。

安装步骤

  1. 安装 Node.js: 确保你的系统已安装 Node.js (推荐 18.x 或更高版本)。
  2. 安装 Graphlit MCP Server: 使用 npm 或 npx 命令进行安装:
    npx install graphlit-mcp-server

服务器配置

为了让 MCP 客户端(例如 Cursor, Windsurf 或 Cline)连接到 Graphlit MCP Server,需要在客户端的 MCP 服务器配置中添加以下 JSON 配置信息。请根据你的 Graphlit 平台账号信息,替换 'env' 中的占位符。

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",  // 替换为你的 Graphlit Organization ID
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",    // 替换为你的 Graphlit Environment ID
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret"       // 替换为你的 Graphlit JWT Secret
            }
        }
    }
}

配置参数说明:

  • 'server name': 'graphlit-mcp-server' (服务器名称,可自定义)
  • 'command': 'npx' (启动命令,使用 npx 运行)
  • 'args':
    • '-y': (npx 参数,自动确认安装)
    • 'graphlit-mcp-server': (运行 graphlit-mcp-server 包)
  • 'env': 环境变量配置
    • 'GRAPHLIT_ORGANIZATION_ID': 你的 Graphlit 组织 ID,在 Graphlit 平台 API 设置中获取。
    • 'GRAPHLIT_ENVIRONMENT_ID': 你的 Graphlit 环境 ID,在 Graphlit 平台 API 设置中获取。
    • 'GRAPHLIT_JWT_SECRET': 你的 Graphlit JWT Secret,用于 JWT 签名,在 Graphlit 平台 API 设置中获取。

可选配置:

如果需要使用数据连接器功能 (例如 Slack, Google Email, Notion 等),你还需要在 'env' 中配置相应数据源的凭据,具体环境变量名称请参考 'README.md' 文档的 "Optionally, you can configure the credentials for data connectors" 部分。

基本使用方法

  1. 启动 MCP 客户端: 打开并配置支持 MCP 协议的客户端,例如 Cursor, Windsurf 或 Cline。
  2. 配置 MCP 服务器: 在客户端的设置中,添加上面提供的 JSON 配置信息,并确保配置中的 'GRAPHLIT_ORGANIZATION_ID', 'GRAPHLIT_ENVIRONMENT_ID', 'GRAPHLIT_JWT_SECRET' 已替换为你的 Graphlit 平台账号信息。
  3. 连接 MCP 服务器: 客户端会自动尝试连接到 Graphlit MCP Server。
  4. 使用工具和资源: 在客户端中,你可以通过自然语言指令或图形界面,调用 Graphlit MCP Server 提供的工具(例如 'retrieveSources', 'extractText', 'ingestUrl' 等)和资源(例如 'contents://', 'feeds://', 'collections://'),与 Graphlit 知识库进行交互,实现知识检索、数据摄取等功能。

具体工具和资源的使用方法,请参考工具和资源的描述信息,以及 Graphlit 平台的官方文档。

信息

分类

AI与计算