de en es ja ko ru zh

SAG MCP Server

Name: SAG MCP Server
Author: guazixiong

by guazixiong

Overview Schema Source Related Servers Discussions Admin

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: MCP RAG 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 deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Nebelus A
ai.nebelus.api
MCP facade over the Nebelus Construction API. ~48 tools give full agent build parity: create/update/probe agents, edit graphs, attach knowledge and vector stores, wire connectors, set governance policies and locked guardrails, enable grounding-trace, and read deployment wiring. Purpose-built for regulated industries: data residency is enforced per region (EU / GCC-KSA), with PII controls and an audit trail. Agents are created as drafts — no deploy tool is exposed over MCP by design; publishing happens in the Nebelus console.
Agent Orchestration Autonomous Agents Developer Tools
561
Knowledge Raven
com.knowledge-raven
Make your knowledge agent-ready. One MCP endpoint, 5 connectors, 3 search modes.
RAG Systems Knowledge & Memory Search
2
brainatticOAuth
ai.brainattic
The knowledge base your AI reads and writes, under your rules — over MCP, EU-hosted.
Knowledge & Memory Search
2
Algenta MCP Server A
io.github.thyn-ai
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Data Platforms Search RAG Systems
1402

Related MCP Servers

Daniel LightRAG MCP Server
RAG Systems Knowledge & Memory Documentation Access
desimpkins
A
license
Not graded
quality
F
maintenance
A comprehensive MCP server that provides full integration with LightRAG API, offering 22 tools across document management, querying, knowledge graph operations, and system management.
Updated a year ago (2025-08-22 02:52 UTC)
37
MIT
MCP RAG Server
RAG Systems Vector Databases
amaralphp
A
license
Not graded
quality
C
maintenance
Enables document ingestion, semantic search, and retrieval-augmented generation via MCP tools and REST API, using vector embeddings and intelligent chunking.
Updated 2 months ago (2026-07-28 13:03 UTC)
MIT
fayna-rag-mcpofficial
RAG Systems Search
fayna-digital
A
license
Not graded
quality
B
maintenance
Enables local knowledge base management with retrieval-augmented generation (RAG), providing semantic search, document reading, listing, and Q&A via MCP tools and REST endpoints, all running locally without cloud dependencies.
Updated a month ago (2026-08-28 21:46 UTC)
MIT
kb-mcp-server
RAG Systems AI & Machine Learning Customer Support
Doy369
F
license
Not graded
quality
B
maintenance
Enables to build and query a knowledge base with retrieval-augmented generation, supporting document ingestion, hybrid search, and live data integration from external APIs via MCP tools.
Updated 8 days ago (2026-09-30 06:52 UTC)
2
-

SAG MCP Server

기능

빠른 시작

1. 사전 요구 사항

2. 설치

3. 실행

4. Claude Desktop에서 연결

도구

구성

클라이언트 구성

Claude Desktop

Cursor

Dify

Docker

개발

API 호환성

라이선스

中文文档

特性

快速开始

1. 前提条件

2. 安装

3. 启动

4. 连接 Claude Desktop

工具清单

配置说明

客户端配置

Claude Desktop

Cursor

Dify

Docker 部署

开发指南

API 兼容性

许可证

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Daniel LightRAG MCP Server

MCP RAG Server

fayna-rag-mcpofficial

kb-mcp-server