Skip to main content
Glama
deenesjakoruzh
guazixiong

SAG MCP Server

by guazixiong
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

SAG MCP Server

Python 3.10+ License: MIT MCP

English | 中文

SAG 지식 베이스를 위한 전체 읽기/쓰기 MCP 서버입니다. Streamable HTTP 전송을 통해 18개의 도구를 제공하며, Claude Desktop, Cursor, VS Code 및 모든 MCP 클라이언트와 호환됩니다.

기능

  • 18개 도구: 소스/문서 CRUD, 의미 검색, 지식 그래프 쿼리, 모델 구성

  • Streamable HTTP: 로컬 종속성 없이 모든 MCP 클라이언트에서 연결

  • Bearer 인증: JWT 토큰 인증 내장

  • 제로 구성: 실행 중인 SAG 인스턴스와 즉시 연동

Related MCP server: LightRAG MCP Server

빠른 시작

1. 사전 요구 사항

실행 중인 SAG 인스턴스(Docker 또는 네이티브). SAG 배포 가이드 참조.

2. 설치

pip install sag-mcp-server

또는 소스에서:

git clone https://github.com/Zleap-AI/sag-mcp-server.git
cd sag-mcp-server
pip install -e .

3. 실행

HTTP 모드(권장):

export SAG_API_URL=http://your-sag-host:9002
sag-mcp-server http 9003

stdio 모드(로컬 통합용):

sag-mcp-server stdio

4. Claude Desktop에서 연결

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "sag": {
      "type": "http",
      "url": "http://your-sag-host:9003/mcp/",
      "headers": {
        "Authorization": "Bearer <your-jwt-token>"
      }
    }
  }
}

토큰 가져오기:

curl -s -X POST http://your-sag-host:9002/api/v1/auth/login \
  -H 'Content-Type: application/json' -d '{"name":"Admin"}' \
  | python3 -c "import sys,json;print(json.load(sys.stdin)['access_token'])"

도구

카테고리

도구

설명

소스

list_sources

모든 지식 베이스 소스 나열

create_source

새 소스 생성

delete_source

소스 및 모든 데이터 삭제

문서

list_documents

소스 내 문서 나열

upload_document

로컬 파일 업로드(자동 파싱 + 추출)

ingest_text

텍스트 직접 작성(파일 불필요)

reprocess_document

문서 재처리

pause_document

처리 일시 중지

resume_document

처리 재개

delete_document

문서 삭제

검색

search

LLM 요약이 포함된 의미 검색

get_entity

지식 그래프 엔티티 쿼리

outline

문서 개요 가져오기

grep

키워드/정규식 검색

read_document

전체 문서 텍스트 읽기

구성

get_model_config

모델 구성 보기

update_model_config

모델 설정 업데이트

test_model_config

모델 연결 테스트

구성

모든 구성은 환경 변수를 통해 설정:

변수

기본값

설명

SAG_API_URL

http://localhost:9002

SAG API 기본 URL

SAG_TOKEN

(비어 있음 = 자동 로그인)

JWT Bearer 토큰

SAG_LOGIN_NAME

Admin

로그인 사용자 이름(토큰이 비어 있을 때)

SAG_MCP_PORT

9003

HTTP 서버 포트

클라이언트 구성

Claude Desktop

{
  "mcpServers": {
    "sag": {
      "type": "http",
      "url": "http://your-sag-host:9003/mcp/",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "sag": {
      "type": "http",
      "url": "http://your-sag-host:9003/mcp/",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Dify

  • 유형: Streamable HTTP

  • URL: http://your-sag-host:9003/mcp/

  • 헤더: Authorization: Bearer <token>

Docker

SAG와 함께 컨테이너로 실행:

# docker-compose.yml addition
services:
  mcp:
    build: .
    environment:
      SAG_API_URL: http://api:8000
      SAG_SECRET_KEY: ${SAG_SECRET_KEY}
    ports:
      - "9003:9003"
    command: ["sag-mcp-server", "http", "9003"]
    depends_on:
      api:
        condition: service_healthy

개발

git clone https://github.com/Zleap-AI/sag-mcp-server.git
cd sag-mcp-server
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/

API 호환성

SAG v0.7.x+ 및 다음 엔드포인트 필요:

  • POST /api/v1/auth/login — JWT 인증

  • GET/POST/DELETE /api/v1/sources — 소스 CRUD

  • GET/POST/DELETE /api/v1/sources/{id}/documents — 문서 CRUD

  • POST /api/v1/search — 의미 검색

  • GET /api/v1/system/model-config — 모델 구성

라이선스

MIT License. 자세한 내용은 LICENSE 참조.

中文文档

English | 中文

基于 SAG 知识库的读写 MCP Server。通过 Streamable HTTP 暴露 18 个工具，兼容 Claude Desktop、Cursor、VS Code 及所有 MCP 客户端。

特性

  • 18 个工具：信源/文档增删改查、语义检索、知识图谱查询、模型配置

  • Streamable HTTP：无需本地安装任何依赖，客户端通过 HTTP 直连

  • Bearer 鉴权：内置 JWT token 认证

  • 零配置：与运行中的 SAG 实例直接配合使用

快速开始

1. 前提条件

运行中的 SAG 实例（Docker 或原生部署）。参见 SAG 部署指南。

2. 安装

pip install sag-mcp-server

或从源码安装：

git clone https://github.com/Zleap-AI/sag-mcp-server.git
cd sag-mcp-server
pip install -e .

3. 启动

HTTP 模式（推荐）：

export SAG_API_URL=http://your-sag-host:9002
sag-mcp-server http 9003

stdio 模式（本地集成）：

sag-mcp-server stdio

4. 连接 Claude Desktop

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "sag": {
      "type": "http",
      "url": "http://your-sag-host:9003/mcp/",
      "headers": {
        "Authorization": "Bearer <your-jwt-token>"
      }
    }
  }
}

获取 token：

curl -s -X POST http://your-sag-host:9002/api/v1/auth/login \
  -H 'Content-Type: application/json' -d '{"name":"Admin"}' \
  | python3 -c "import sys,json;print(json.load(sys.stdin)['access_token'])"

工具清单

类别

工具

说明

信源

list_sources

列出所有知识库信源

create_source

创建新信源

delete_source

删除信源及全部数据

文档

list_documents

列出信源下文档

upload_document

上传本地文件（自动解析+抽取）

ingest_text

直接写入文本（无需文件）

reprocess_document

重新处理文档

pause_document

暂停处理

resume_document

恢复处理

delete_document

删除文档

检索

search

语义检索（含 LLM 摘要）

get_entity

查询知识图谱实体

outline

获取文档大纲

grep

关键词/正则检索

read_document

读取文档全文

模型

get_model_config

查看模型配置

update_model_config

更新模型设置

test_model_config

测试模型连通性

配置说明

所有配置通过环境变量：

变量

默认值

说明

SAG_API_URL

http://localhost:9002

SAG API 地址

SAG_TOKEN

（空=自动登录）

JWT Bearer token

SAG_LOGIN_NAME

Admin

登录用户名（token 为空时生效）

SAG_MCP_PORT

9003

HTTP 服务端口

客户端配置

Claude Desktop

{
  "mcpServers": {
    "sag": {
      "type": "http",
      "url": "http://your-sag-host:9003/mcp/",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "sag": {
      "type": "http",
      "url": "http://your-sag-host:9003/mcp/",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Dify

  • 类型：Streamable HTTP

  • URL：http://your-sag-host:9003/mcp/

  • 请求头：Authorization: Bearer <token>

Docker 部署

与 SAG 一起以容器方式运行：

# 添加到 docker-compose.yml
services:
  mcp:
    build: .
    environment:
      SAG_API_URL: http://api:8000
      SAG_SECRET_KEY: ${SAG_SECRET_KEY}
    ports:
      - "9003:9003"
    command: ["sag-mcp-server", "http", "9003"]
    depends_on:
      api:
        condition: service_healthy

开发指南

git clone https://github.com/Zleap-AI/sag-mcp-server.git
cd sag-mcp-server
pip install -e ".[dev]"

# 运行测试
pytest

# 代码检查
ruff check src/

API 兼容性

需要 SAG v0.7.x+，支持以下接口：

  • POST /api/v1/auth/login — JWT 认证

  • GET/POST/DELETE /api/v1/sources — 信源增删改查

  • GET/POST/DELETE /api/v1/sources/{id}/documents — 文档增删改查

  • POST /api/v1/search — 语义检索

  • GET /api/v1/system/model-config — 模型配置

许可证

MIT License。详见 LICENSE。

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • OntoRamp Knowledge Cartographer

    Knowledge coverage map and health score. Ingest docs into a governed knowledge graph via MCP.

  • SRG+

    Manage SRG+ hubs, channels, content, assets, users, and workspaces from any MCP-aware AI agent.

  • XMemo

    Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/guazixiong/sag-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server