Graphlit MCP Server

社区

将 Graphlit 平台无缝集成到 MCP 客户端，实现内容的摄取、搜索与 RAG 知识库。

分类: 其他第 30 / 230
Stars: ★ 378 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 9 个月前 ⚠
工具数: 59

66FMRS · C

Graphlit MCP 服务器是一个功能丰富的工具，用于将 Graphlit 平台集成到 MCP 客户端中，提供广泛的数据摄取、搜索和 RAG 功能。它适合需要集中管理多种数据源并希望利用 LLM 进行查询的团队。但需要注意的是，它依赖于付费的 Graphlit 服务，并且需要配置多个凭据。对于非开发者或不需要复杂知识管理的用户，可能过于复杂。

最强项 · 维护活跃度 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

13/20

维护活跃度

16/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 8/20: 证据：服务器通过npx直接运行，入口为src/index.js，导出server对象并通过stdio传输；仓库包含GitHub Actions（CI）对Node 16/18/20进行npm测试，并有mcp-inspector测试工作流。代码将大量Graphlit方法封装为工具，并声明了详细工具列表。扣分：未发现针对实际MCP初始化和工具调用的单元/集成测试；工具参数大多以宽松的JSON value形式传递，运行期错误依赖外部Graphlit API，无本地验证；README为唯一运行证据，无法确认所有工具的真实行为。
安全与权限 13/20: 证据：认证凭据（GRAPHLIT_ORGANIZATION_ID、GRAPHLIT_ENVIRONMENT_ID、GRAPHLIT_JWT_SECRET及可选连接器令牌）仅通过环境变量注入；代码使用Graphlit SDK（@graphlit/client）进行API调用，未发现外传或日志记录凭据的行为。扣分：服务器涉及大量带副作用的操作（删除内容/源/集合/对话、发布音频/图片、触发器、网络爬取/搜索/截图），且所有工具默认开放，客户端无需确认即可执行删除/发布/爬取操作；README示例仅含占位符，未发现真实密钥；依赖审计或供应链验证不足。
维护活跃度 16/20: 证据：MIT许可证；仓库活跃，stars约379，open issues仅5个；package.json显示版本1.0.53，npm badge显示持续发布；存在GitHub Actions CI（node 16/18/20）和mcp-inspector测试工作流；README链接官方文档、Discord和GitHub Issues支持渠道。扣分：无SECURITY.md或安全响应渠道；依赖更新频率和发布节奏从静态文件中无法验证；问题关闭率无法从现有文件确认。
文档质量 15/20: 证据：README结构清晰，覆盖概览、工具清单、前提条件、VS Code/Windsurf/Cline/Cursor/Smithery安装示例、手动配置、可选连接器环境变量、支持渠道；附带博客、YouTube和Glama徽章。扣分：未提供每个工具的输入schema或参数文档；未说明配额/成本/速率限制；故障排查部分缺失；全凭README自述，缺少API参考或与工具列表对应的详细说明。
安装易用性 14/20: 证据：安装路径简单明确——通过npx -y graphlit-mcp-server运行；README提供了VS Code、Windsurf、Cline、Cursor、Smithery及手动配置的JSON示例；需要三个核心环境变量，可选连接器变量也有示例；还给出Windows下cmd /c npx的提示。扣分：未实际执行验证；credential获取依赖Graphlit平台注册并手动从仪表盘复制，步骤虽必要但未详细展开；README未提供npx首次拉取失败或网络问题的排查；由于静态约束，不能给予15以上。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

开发者和管理者希望将多种数据源整合到一个可搜索的知识库中。
需要从非结构化文档中提取信息，并用于 LLM 驱动的应用。
已经使用 Graphlit 平台或希望尝试其功能的团队。

不适合谁

仅需要简单网络搜索或无需数据持久化的用户。
需要本地存储或开源服务的用户，因为 Graphlit 是托管云平台。
寻求完全离线或私有化部署的用户。

所需权限

需要 Graphlit 环境 ID、组织 ID 和 JWT 密钥进行认证。
可选：数据连接器的令牌，如 Slack Bot Token、Discord Bot Token、Google OAuth 凭据等，用于访问外部服务。
MCP 客户端需要执行 npx 命令，因此需要网络访问和 Node.js 环境。

风险与副作用

数据安全：连接器需要访问外部服务的数据，确保服务的权限设置最小化。
成本：Graphlit 是收费服务，使用不当可能产生费用。
凭据泄露：环境变量包含敏感信息，必须妥善保管，避免在共享配置中泄露。
第三方依赖：服务器通过 npx 下载，可能引入供应链风险。

安装接入

准备工作

运行环境：Node.js 18+

GRAPHLIT_ORGANIZATION_ID 必填 Graphlit 组织 ID，可在 Graphlit Platform (portal.graphlit.dev) 的 API 设置面板获取。

GRAPHLIT_ENVIRONMENT_ID 必填 Graphlit 环境 ID，可在 Graphlit Platform 的 API 设置面板获取。

GRAPHLIT_JWT_SECRET 必填密钥用于签名 JWT 的密钥，可在 Graphlit Platform 的 API 设置面板获取。

SLACK_BOT_TOKEN 可选密钥可选，Slack 机器人的 token，用于 Slack 数据连接器和通知。

DISCORD_BOT_TOKEN 可选密钥可选，Discord 机器人的 token，用于 Discord 数据连接器。

TWITTER_TOKEN 可选密钥可选，Twitter/X 的 token，用于数据连接器和通知。

GOOGLE_EMAIL_REFRESH_TOKEN 可选密钥可选，Google 邮件刷新 token，用于 Gmail 连接器。

GOOGLE_EMAIL_CLIENT_ID 可选密钥可选，Google OAuth 客户端 ID，用于 Gmail 连接器。

GOOGLE_EMAIL_CLIENT_SECRET 可选密钥可选，Google OAuth 客户端密钥，用于 Gmail 连接器。

LINEAR_API_KEY 可选密钥可选，Linear API 密钥，用于 Linear 数据连接器。

GITHUB_PERSONAL_ACCESS_TOKEN 可选密钥可选，GitHub 个人访问令牌，用于 GitHub 数据连接器。

JIRA_TOKEN 可选密钥可选，Jira API token，用于 Jira 数据连接器。

NOTION_API_KEY 可选密钥可选，Notion API 密钥，用于 Notion 数据连接器。

其他可选配置项（1 个）

JIRA_EMAIL 可选可选，Jira 账户邮箱，用于 Jira 数据连接器。

确保已安装 Node.js 18 或更高版本。
在 MCP 客户端配置中添加服务器，使用命令 npx -y graphlit-mcp-server，并设置 GRAPHLIT_ORGANIZATION_ID、GRAPHLIT_ENVIRONMENT_ID 和 GRAPHLIT_JWT_SECRET 环境变量。
可选：配置数据连接器的凭据，如 Slack、Google Email 和 Notion。
启动客户端，服务器将自动连接。

claude_desktop_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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add graphlit-mcp-server -e GRAPHLIT_ORGANIZATION_ID=your-organization-id -e GRAPHLIT_ENVIRONMENT_ID=your-environment-id -e GRAPHLIT_JWT_SECRET=your-jwt-secret -- npx -y graphlit-mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中确认出现 Query Contents、Web Search、Ingest Web Page 等 graphlit-mcp-server 工具；运行一次 Web Search 查询，能返回结果即说明连接成功。

常见排障

如果连接失败，请检查环境变量是否正确设置，特别是 GRAPHLIT_JWT_SECRET。
确保 Node.js 版本不低于 18，并确认可以正常执行 `npx` 命令。
在 Windows 上，可能需要在命令前添加 `cmd /c`。
如果特定数据连接器（如 Slack）无法工作，请检查对应的令牌或 OAuth 凭据是否有效且具有必要权限。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我抓取并索引这个网页：https://www.graphlit.com/blog，然后总结它的内容。
搜索我已摄入的 GitHub issue，找出与 MCP 相关的内容。
从这段文字中提取结构化 JSON 数据。
列出我 Slack 工作区中的频道。

工具能力 59

Query Contents 只读

查询项目中的内容。

Query Collections 只读

查询项目中的内容集合。

Query Feeds 只读

查询项目中的订阅源。

Query Conversations 只读

查询项目中的对话。

Retrieve Relevant Sources 只读

检索与查询相关的来源。

Retrieve Similar Images 只读

检索与图像相似的图像。

Visually Describe Image 只读

视觉描述图像内容。

Prompt LLM Conversation 只读

向 LLM 发起对话提示，进行 RAG 查询。

展开其余 51 个工具

Extract Structured JSON from Text 只读

从文本中提取结构化 JSON 数据。

Publish as Audio 写入

使用 ElevenLabs 将内容发布为音频。

Publish as Image 写入

使用 OpenAI 图像生成将内容发布为图像。

Ingest File 写入

摄取文件到项目中。

Ingest Web Page 写入

摄取网页到项目中。

Ingest Message 写入

摄取消息（如 Slack、Teams）到项目中。

Ingest Post 写入

摄取帖子（如 Discord、Reddit）到项目中。

Ingest Email 写入

摄取邮件到项目中。

Ingest Issue 写入

摄取问题（如 Jira、GitHub）到项目中。

Ingest Text 写入

摄取文本内容到项目中。

Ingest Memory 写入

摄取短期记忆数据。

Ingest from Slack 写入

从 Slack 摄取数据。

Ingest from Discord 写入

从 Discord 摄取数据。

Ingest from Website 写入

从网站摄取数据。

Ingest from Google Drive 写入

从 Google Drive 摄取数据。

Ingest from Email 写入

从邮件摄取数据。

Ingest from Jira 写入

从 Jira 摄取数据。

Ingest from Linear 写入

从 Linear 摄取数据。

Ingest from GitHub 写入

从 GitHub 摄取数据。

Web Crawling 只读

爬取网站内容。

Web Search 只读

执行网络搜索（包括播客搜索）。

Web Mapping 只读

映射网站结构。

Screenshot Page 只读

截取网页截图。

Notify via Slack 破坏性

通过 Slack 发送通知。

Notify via Email 破坏性

通过邮件发送通知。

Notify via Webhook 破坏性

通过 Webhook 发送通知。

Notify via Twitter/X 破坏性

通过 Twitter/X 发送通知。

Configure Project 写入

配置项目设置。

Create Collection 写入

创建内容集合。

Add Contents to Collection 写入

将内容添加到集合。

Remove Contents from Collection 写入

从集合中移除内容。

Delete Collections 破坏性

删除一个或多个集合。

Delete Feeds 破坏性

删除一个或多个订阅源。

Delete Contents 破坏性

删除一个或多个内容。

Delete Conversations 破坏性

删除一个或多个对话。

Is Feed Done? 只读

检查订阅源是否完成摄取。

Is Content Done? 只读

检查内容是否完成处理。

List Slack Channels 只读

列出 Slack 频道。

List Microsoft Teams Teams 只读

列出 Microsoft Teams 团队。

List Microsoft Teams Channels 只读

列出 Microsoft Teams 频道。

List SharePoint Libraries 只读

列出 SharePoint 库。

List SharePoint Folders 只读

列出 SharePoint 文件夹。

List Linear Projects 只读

列出 Linear 项目。

List Notion Databases 只读

列出 Notion 数据库。

List Notion Pages 只读

列出 Notion 页面。

List Dropbox Folders 只读

列出 Dropbox 文件夹。

List Box Folders 只读

列出 Box 文件夹。

List Discord Guilds 只读

列出 Discord 服务器。

List Discord Channels 只读

列出 Discord 频道。

List Google Calendars 只读

列出 Google 日历。

List Microsoft Calendars 只读

列出 Microsoft 日历。

使用场景

在 IDE 中直接摄取和搜索项目文档、网页和代码仓库内容。

构建跨 Slack、Discord、GitHub 等工具的统一知识库。

通过自然语言查询进行 RAG，无需切换上下文。

自动化内容摄取流程，如网站爬取和文档处理。

支持客户端

Claude Desktop

Cursor

Windsurf

Goose

Cline

依据项目文档列出，未经本站实测。

详细介绍

Graphlit MCP 服务器允许 MCP 客户端（如 Cursor、Windsurf、Goose 或 Cline）与 Graphlit 平台集成。您可以摄取来自 Slack、Discord、网站、Google Drive、邮件、Jira、Linear 或 GitHub 等任意内容，并在客户端内搜索和检索相关知识。文档（PDF、DOCX、PPTX 等）和 HTML 网页在摄取时会被提取为 Markdown，音频和视频文件会被转录。内置了网络爬取和网络搜索功能，无需额外集成其他工具。您的 Graphlit 项目可作为跨开发工具和产品管理工具的可搜索、RAG-ready 知识库。