Model Context Protocol (MCP) Server for Graphlit Platform

Graphlit Platform 的 Model Context Protocol（MCP）服务

概览

Model Context Protocol（MCP）服务支持 MCP 客户端与 Graphlit 服务集成。本文档介绍了设置流程，并提供了一个使用客户端的基本示例。

将 Slack、Discord、网站、Google Drive、电子邮件、Jira、Linear 或 GitHub 中的任何内容导入 Graphlit 项目，然后在 Cursor、Windsurf、Goose 或 Cline 等 MCP 客户端中搜索和检索相关知识。

你的 Graphlit 项目可作为涵盖所有开发和产品管理工具的可搜索、支持 RAG 的知识库。

文档（PDF、DOCX、PPTX 等）和 HTML 网页将在导入时提取为 Markdown。音频和视频文件将在导入时转录。

MCP 工具内置了网页爬取和网页搜索，无需单独集成 Firecrawl、Exa 等其他工具。

你可以在我们的博客上进一步了解 MCP 服务的用例和功能。

观看我们最新的 YouTube 视频，了解如何将 Graphlit MCP 服务与 Goose MCP 客户端搭配使用。

如果对 MCP 服务的使用有任何疑问，请加入我们的 Discord 社区，并在 #mcp 频道发帖。

工具

检索

• 查询内容
• 查询集合
• 查询 Feed
• 查询对话
• 检索相关来源
• 检索相似图像
• 以视觉方式描述图像

RAG

• 提示词 LLM 对话

提取

• 从文本中提取结构化 JSON

发布

• 发布为音频（ElevenLabs Audio）
• 发布为图像（OpenAI Image Generation）

导入

• 文件
• 网页
• 消息
• 帖子
• 电子邮件
• 问题
• 文本
• 记忆（短期）

数据连接器

• Microsoft Outlook 电子邮件
• Google Mail
• Notion
• Reddit
• Linear
• Jira
• GitHub Issues
• Google Drive
• OneDrive
• SharePoint
• Dropbox
• Box
• GitHub
• Slack
• Microsoft Teams
• Discord
• Twitter/X
• 播客（RSS）

Web

• 网页爬取
• 网页搜索（包括播客搜索）
• 网页映射
• 页面截图

通知

• Slack
• 电子邮件
• Webhook
• Twitter/X

操作

• 配置项目
• 创建集合
• 将内容添加到集合
• 从集合中移除内容
• 删除集合
• 删除 Feed
• 删除内容
• 删除对话
• Feed 是否已完成？
• 内容是否已完成？

枚举

• 列出 Slack 频道
• 列出 Microsoft Teams 团队
• 列出 Microsoft Teams 频道
• 列出 SharePoint 库
• 列出 SharePoint 文件夹
• 列出 Linear 项目
• 列出 Notion 数据库
• 列出 Notion 页面
• 列出 Dropbox 文件夹
• 列出 Box 文件夹
• 列出 Discord Guild
• 列出 Discord 频道
• 列出 Google 日历
• 列出 Microsoft 日历

资源

• 项目
• 内容
• Feed
• 集合（内容集合）
• 工作流
• 对话
• 规范

前提条件

开始之前，请确保具备以下条件：

• 系统已安装 Node.js（建议版本为 18.x 或更高）。
• 拥有有效的 Graphlit Platform 账户，并可访问 API 设置仪表板。

配置

Graphlit MCP Server 支持通过环境变量进行身份验证和配置：

• GRAPHLIT_ENVIRONMENT_ID：你的环境 ID。
• GRAPHLIT_ORGANIZATION_ID：你的组织 ID。
• GRAPHLIT_JWT_SECRET：用于签署 JWT 令牌的 JWT 密钥。

你可以在 Graphlit Platform 的 API 设置控制面板中找到这些值。

安装

通过 VS Code 安装

如需快速安装，请使用下面的一键安装按钮：

如需手动安装，请将以下 JSON 代码块添加到 VS Code 中的 User Settings (JSON) 文件。你可以按 Ctrl + Shift + P，然后输入 Preferences: Open User Settings (JSON) 来完成此操作。

你也可以选择将其添加到工作区中的 .vscode/mcp.json 文件。这样便可以与他人共享配置。

注意，.vscode/mcp.json 文件中不需要 mcp 键。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "organization_id",
        "description": "Graphlit Organization ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "environment_id",
        "description": "Graphlit Environment ID",
        "password": true
      },
      {
        "type": "promptString",
        "id": "jwt_secret",
        "description": "Graphlit JWT Secret",
        "password": true
      }
    ],
    "servers": {
      "graphlit": {
        "command": "npx",
        "args": ["-y", "graphlit-mcp-server"],
        "env": {
          "GRAPHLIT_ORGANIZATION_ID": "${input:organization_id}",
          "GRAPHLIT_ENVIRONMENT_ID": "${input:environment_id}",
          "GRAPHLIT_JWT_SECRET": "${input:jwt_secret}"
        }
      }
    }
  }
}

通过 Windsurf 安装

要在 Windsurf IDE 应用程序中安装 graphlit-mcp-server，Cline 应使用 NPX：

npx -y graphlit-mcp-server

你的 mcp_config.json 文件应采用类似以下的配置：

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

通过 Cline 安装

要在 Cline IDE 应用程序中安装 graphlit-mcp-server，Cline 应使用 NPX：

npx -y graphlit-mcp-server

你的 cline_mcp_settings.json 文件应采用类似以下的配置：

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

通过 Cursor 安装

要在 Cursor IDE 应用程序中安装 graphlit-mcp-server，Cursor 应使用 NPX：

npx -y graphlit-mcp-server

你的 mcp.json 文件应采用类似以下的配置：

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 graphlit-mcp-server：

npx -y @smithery/cli install @graphlit/graphlit-mcp-server --client claude

手动安装

要在任何 MCP 客户端应用程序中使用 Graphlit MCP Server，请使用：

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
            }
        }
    }
}

你也可以选择配置数据连接器的凭据，例如 Slack、Google Email 和 Notion。 只需设置 GRAPHLIT_ORGANIZATION_ID、GRAPHLIT_ENVIRONMENT_ID 和 GRAPHLIT_JWT_SECRET。

{
    "mcpServers": {
        "graphlit-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "graphlit-mcp-server"
            ],
            "env": {
                "GRAPHLIT_ORGANIZATION_ID": "your-organization-id",
                "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id",
                "GRAPHLIT_JWT_SECRET": "your-jwt-secret",
                "SLACK_BOT_TOKEN": "your-slack-bot-token",
                "DISCORD_BOT_TOKEN": "your-discord-bot-token",
                "TWITTER_TOKEN": "your-twitter-token",
                "GOOGLE_EMAIL_REFRESH_TOKEN": "your-google-refresh-token",
                "GOOGLE_EMAIL_CLIENT_ID": "your-google-client-id",
                "GOOGLE_EMAIL_CLIENT_SECRET": "your-google-client-secret",
                "LINEAR_API_KEY": "your-linear-api-key",
                "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-pat",
                "JIRA_EMAIL": "your-jira-email",
                "JIRA_TOKEN": "your-jira-token",
                "NOTION_API_KEY": "your-notion-api-key"
            }
        }
    }
}

注意：在 Windows 上运行 npx 时，你可能需要通过命令提示符显式调用 npx。

"command": "C:\\Windows\\System32\\cmd.exe /c npx"

支持

请参阅 Graphlit API 文档。

如需 Graphlit MCP Server 方面的支持，请提交 GitHub Issue。

如需 Graphlit Platform 方面的进一步支持，请加入我们的 Discord 社区。