Graphlit平台的模型上下文协议(MCP)服务器

概述

模型上下文协议(MCP)服务器实现了MCP客户端与Graphlit服务之间的集成。本文档介绍了设置流程，并提供了使用客户端的基本示例。

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

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

文档（PDF、DOCX、PPTX等）和HTML网页在摄入时会被提取为Markdown格式。音频和视频文件在摄入时会被转录。

Web爬取和网络搜索作为内置的MCP工具提供，无需单独集成Firecrawl、Exa等其他工具。

你可以在我们的博客上了解更多关于MCP服务器的使用场景和功能。

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

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

工具

检索

• 查询内容
• 查询集合
• 查询订阅源
• 查询对话
• 检索相关来源
• 检索相似图像
• 视觉描述图像

RAG

• 提示LLM对话

提取

• 从文本中提取结构化JSON

发布

• 作为音频发布（ElevenLabs音频）
• 作为图像发布（OpenAI图像生成）

摄入

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

数据连接器

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

Web

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

通知

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

操作

• 配置项目
• 创建集合
• 向集合添加内容
• 从集合中删除内容
• 删除集合
• 删除订阅源
• 删除内容
• 删除对话
• 订阅源是否完成？
• 内容是否完成？

枚举

• 列出Slack频道
• 列出Microsoft Teams团队
• 列出Microsoft Teams频道
• 列出SharePoint库
• 列出SharePoint文件夹
• 列出Linear项目
• 列出Notion数据库

资源

• 项目
• 内容
• 订阅源
• 内容集合
• 工作流
• 对话
• 规格

前提条件

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

• 系统上安装了Node.js（推荐版本18.x或更高）。
• 在Graphlit平台上拥有活跃账户，并可访问API设置仪表板。

配置

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

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

你可以在Graphlit平台的API设置仪表板中找到这些值。

安装

通过VS Code安装

要快速安装，请使用以下一键安装按钮之一：

对于手动安装，请将以下JSON块添加到VS Code的用户设置（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服务器，请使用：

{
    "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电子邮件和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服务器的支持，请提交GitHub问题。

如需进一步支持Graphlit平台，请加入我们的Discord社区。