graphjin

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

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 206 🐛 待处理 18 👀 关注 43

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3234

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队dosco

官网地址https://graphjin.com

GitHubhttps://github.com/dosco/graphjin

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议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 星标★ 3234

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

代码更新2026-11-06

仓库体积201.4 MB

本站数据更新2026-11-07

维护状态活跃

收录时间2026-08-09

浏览次数7

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3234

技术标签

agentic-ai ai-agents cloud-native database graphql

使用教程

难度：入门约 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/<name> 端点也仅在 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 用法在节选中只有链接、没有完整示例，需查阅官网文档