graphjin

给AI代理一个统一数据入口，安全读写数据库和API

GraphJin 是一个面向 AI 代理的治理型数据访问层，将 GraphQL 与 MCP（模型上下文协议）结合，统一对接数据库、文件、API 和代码。它解决了 AI 代理在访问企业数据时面临的权限分散、接口碎片化和安全管控难的问题，提供单一治理入口，让代理通过 GraphQL 查询或 MCP 工具调用即可安全读写数据。核心能力包括：自动生成 GraphQL 模式、内置 SQL 注入防护、细粒度授权策略、支持多种数据库（PostgreSQL、MySQL、SQL Server、Oracle、MongoDB 等），并能将 REST API 和文件系统映射为可查询的图。项目用 Go 编写，性能高，部署简单，适合作为 AI 应用的后端数据网关。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3173

维护状态较活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队dosco

所属国家

官网地址https://graphjin.com

GitHubhttps://github.com/dosco/graphjin

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型agentic-ai,ai-agents,cloud-native,cockroachdb,database,graphql,llm,mariadb,mcp,mongodb,mssql,mysql,oracle,postgresql,sql,sqlite,yugabyte

GitHub 星标★ 3173

30天Star增速

HF 下载量

上线时间2019-03-24 00:00:00

最近更新2026-09-22 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数6

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

具备 npm、Homebrew、Scoop 或 Docker 之一的环境（README 仅给出这几种安装方式）
若用 Docker 运行 agent 环境镜像，需要 /tmp 可写（示例用 --tmpfs /tmp:size=1g）
准备一个支持 MCP 的 AI 客户端（README 示例为 Claude）
准备要接入的数据库（PostgreSQL、MySQL、MongoDB 等）及其 host/port/user/dbname

安装与启动步骤

1安装 GraphJin CLI

npm 方式适用于所有平台，全局安装 graphjin 命令行工具；macOS 可用 Homebrew，Windows 可用 Scoop，Linux 从 releases 下载 deb/rpm。
```
npm install -g graphjin
```
2创建 GraphJin 应用

在你希望存放配置的目录下执行，生成名为 my-app 的新应用及其配置文件。
```
graphjin serve new my-app
```
3启动 GraphJin 服务

按上一步生成的目录启动服务，README 中 MCP 接入地址为 http://localhost:8080。
```
graphjin serve --path ./my-app
```
4配置数据库连接

通过配置文件的 databases 段填写数据源信息（type/host/port/user/dbname），README 未给出配置文件具体路径。
5接入 AI 客户端

把 GraphJin 注册为 Claude 的 MCP 服务，之后就能用自然语言问表结构、查数据。
```
graphjin mcp add claude http://localhost:8080
```
6用 Docker 体验

拉取镜像；env 镜像自带演示世界和 113 任务套件，无需挂载任何数据，映射 8090 端口。
```
docker pull dosco/graphjin
docker run -d -p 8090:8090 --tmpfs /tmp:size=1g dosco/graphjin:env-latest
```
7其他平台安装

README 给出的备选安装方式：Homebrew 和 Scoop 各一条命令，按操作系统选择其一即可。
```
brew install dosco/graphjin/graphjin
scoop bucket add graphjin https://github.com/dosco/graphjin-scoop
scoop install graphjin
```

关键配置

配置项	必填	说明	示例
`databases`	是	定义要接入的数据源连接信息，键名可自取（示例为 main）	`{"main": {"type": "postgres", "host": "localhost", "port": 5`
`mcp.legacy_discovery`	否	开启后旧版 MCP 客户端才能调用 execute_workflow 及 REST workflow 接口	`true`

如何确认成功

服务启动后 MCP 接入地址为 http://localhost:8080；Docker env 镜像访问 http://localhost:8090/health，可看到构建、套件与数据集指纹。

常见问题

Q：不知道本地数据库的端口和连接信息怎么办？

A：让 AI 客户端调用 discover_databases 工具扫描系统，它会列出发现的数据库、端口、认证状态；也可让它用 update_current_config 直接写入连接配置。

Q：旧版 MCP 客户端调不了 execute_workflow？

A：需在配置中设置 mcp.legacy_discovery: true；同理，REST 的 /api/v1/workflows/ 端点也仅在 legacy 数据库模式或该开关开启时可用。

Q：只想快速试用，不想接自己的库？

A：运行 docker run -d -p 8090:8090 --tmpfs /tmp:size=1g dosco/graphjin:env-latest，镜像自带演示环境和 113 个任务的验证套件，无需挂载任何东西。

Q：Linux 上如何安装？

A：README 未给出 Linux 命令行安装命令，需从 GitHub releases 页面下载 .deb 或 .rpm 包自行安装。

注意事项

README 未说明配置文件的路径与完整字段，数据库配置请以 graphjin serve new 生成的应用内配置文件为准
命令中的端口 8080（MCP 接入）和 8090（Docker env 镜像）来自 README 示例，实际使用请按需替换
Docker agent 环境镜像要求 /tmp 可写，因为每个 world 会在其中创建自己的数据库
README 提到的 POST /api/v1/agent、ask_graphjin_agent 等 agent 用法在节选中只有链接、没有完整示例，需查阅官网文档

核心亮点

支持多种数据库和API，一套GraphQL搞定所有数据源
内置安全策略和权限控制，AI代理无法越权访问
自动生成模式，省去手写GraphQL schema的时间

不足之处

文档/社区待观察
复杂查询优化可能需要手动调整

适用场景

企业AI助手需要访问多个内部数据库
构建统一数据网关供多个AI代理使用
需要细粒度权限控制的GraphQL API服务

替代项目

Hasura GraphQL Engine、PostGraphile、StepZen

项目介绍

graphjin 是基础设施领域的开源项目，由 dosco 开发，2019 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,173）位列前 30%，在基础设施分类中处于中上游。

近 45 天，它的 GitHub 星标从 3,136 增加到 3,173，净增 37。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：企业AI助手需要访问多个内部数据库。同类可对比的替代方案包括 Hasura GraphQL Engine、PostGraphile、StepZen。

上一篇：rampart

下一篇：infra