synthetic-sciences/delphi
요약
Delphi는 로컬 환경에서 코드, 문서, 논문 등 다양한 소스 자료를 검색하고 컨텍스트를 구축하는 AI 에이전트 개발 도구입니다. 이 시스템은 MCP(Multi-Context Protocol)을 통해 Claude Code, Cursor 등 여러 클라이언트에 통합될 수 있으며, 재현 가능한 컨텍스트 세션 저장 및 코드 변경 영향 추적 기능을 제공합니다.
핵심 포인트
- 로컬에서 코드/문서 검색 및 컨텍스트 구축 가능
- MCP를 통해 다양한 AI 에이전트 클라이언트와 연동
- PostgreSQL 기반으로 변경 불가능한 소스 스냅샷 생성
- 코드, 심볼, 호출 그래프 등 상세 정보 인덱싱 지원
로컬에서 에이전트의 코드, 문서 및 논문을 검색합니다.
npx @synsci/delphi
설치 프로그램은 로컬 스택을 시작하며 Delphi를 Claude Code, Cursor, Windsurf 또는 Claude Desktop에 추가할 수 있습니다. Docker, Git, 그리고 임베딩 제공업체(embeddings provider)가 필요합니다. 로컬 sentence-transformers는 API 키 없이 작동합니다.
delphi # 대시보드 열기
delphi status # 스택 확인
delphi logs -f # 로그 추적
...
대시보드는 localhost:3000에서 실행됩니다. API는 localhost:8742에서 실행됩니다.
소스에서 설치하기
git clone https://github.com/synthetic-sciences/delphi.git
cd delphi
cp env.example .env
...
Delphi를 다른 MCP 클라이언트에 추가하기
대시보드에서 API 키를 생성한 다음, 다음을 추가합니다:
{
"mcpServers": {
"delphi": {
...
| 소스 | 사용 가능한 컨텍스트 |
|---|---|
| 레포지토리(Repositories) | 코드 검색, 심볼, 호출 그래프(call graphs), 관련 테스트 및 문서 |
| ... | |
| 모든 인덱스는 PostgreSQL 데이터베이스에 저장됩니다. 완료된 색인 실행은 변경 불가능한 소스 스냅샷을 생성하므로, 저장된 컨텍스트는 사용했던 정확한 버전을 가리킬 수 있습니다. |
Delphi는 다음 기능을 위한 MCP 도구를 노출합니다:
- 레포지토리, 폴더, 논문, 문서 및 데이터셋 인덱싱;
- 코드, 심볼, 파일, 논문 및 저장된 소스 검색;
- 호출자(callers)와 피호출자(callees) 추적 또는 코드 변경의 영향 확인;
- 작업과 토큰 예산 주변에 컨텍스트 팩 구축;
- 핸드오프를 위한 재현 가능한 컨텍스트 세션 저장;
- 선택적이고 정책 제한이 걸린 연구 작업 실행.
기본 MCP 프로필은 로컬 우선(local-first)입니다. 호스팅 검색 및 Atlas 그래프 도구는 환경 설정을 통해 옵트인(opt-in) 방식입니다.
AI 에이전트
│ MCP
▼
...
backend/ FastAPI, MCP 서버, 워커 및 테스트
frontend/ 로컬 대시보드
landing/ trydelphi.ai
...
env.example를 .env로 복사합니다.
. 공통 설정:
| 환경 변수(Variable) | 목적 (Purpose) |
|---|---|
SERVER_SECRET | JWT 서명 비밀 키 (JWT signing secret) |
SYSTEM_PASSWORD | 로컬 대시보드 비밀번호 (Local dashboard password) |
EMBEDDING_PROVIDER | local, openai, gemini, 또는 hash |
EMBEDDING_MODEL | 임베딩 모델 이름 (Embedding model name) |
EMBEDDING_DEVICE | cpu, cuda, 또는 mps |
SYNSC_ENABLE_RERANKER | 선택적 크로스 인코더 재랭커 활성화 (Enable the optional cross-encoder reranker) |
SYNSC_MCP_PROFILE | 노출할 MCP 도구 세트 선택 (Choose the exposed MCP tool set) |
제공자(provider) 및 네트워크 정책 설정은 docs/env-advanced.md를 참조하십시오. 소규모 로컬 배포의 경우, docs/deployment-lite.md를 참조하십시오.
백엔드 (Backend):
cd backend
uv sync --locked --extra dev
uv run pytest
...
대시보드 (Dashboard):
cd frontend
npm ci
npm run lint
...
랜딩 사이트 (Landing site):
cd landing
corepack pnpm install --frozen-lockfile
corepack pnpm build
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기