ResearchGravity MCP server
2026년 10월 25일 커밋다계층 신호 캡처 및 그래프 기반 지식 관리를 통해 지능을 포착, 저장 및 분석하는 AI 연구 프레임워크입니다.
다른 이름 Dicoangelo/ResearchGravity
- 스타
- 4
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 25일
- 라이선스
- MIT
ResearchGravity MCP란?
다계층 신호 캡처 및 그래프 기반 지식 관리를 통해 지능을 포착, 저장 및 분석하는 AI 연구 프레임워크입니다.
프로젝트 README에서 생성된 요약
ResearchGravity MCP server 정보
독자적인 지식 베이스를 구축하려는 연구자와 개발자는 ResearchGravity를 사용하여 다계층 신호 캡처 시스템을 통해 지능을 포착, 저장 및 분석할 수 있습니다. 이 프레임워크는 AI 세컨드 브레인 역할을 하며, 그래프 기반 관리 시스템을 활용하여 세션, 발견 사항 및 논문 간의 관계를 추적합니다. 오프라인 벡터 저장을 위해 SQLite 및 sqlite-vec를 사용한 로컬 배포를 지원하거나, 전체 시맨틱 검색 기능을 위해 Qdrant와 통합할 수 있습니다.
사용자는 대화형 REPL, CLI 또는 REST API를 통해 시스템과 상호작용합니다. 이 플랫폼은 Claude 세션에서 URL과 발견 사항을 추출하는 자동 캡처 기능과 백그라운드 활동으로부터 세션을 생성하는 파일 와처 데몬을 포함합니다. 고품질 출력을 보장하기 위해 시스템은 라이터-크리틱(writer-critic) 아키텍처와 아카이브 및 증거를 검증하기 위한 오라클 합의 메커니즘을 채택합니다. 보안은 JWT 인증 및 API 엔드포인트의 속도 제한을 통해 관리됩니다.
활용 사례
- 1자동화된 연구 세션 로깅AI 클라이언트가 활성 연구 세션에서 URL과 주요 발견 사항을 자동으로 추출하여 지식 그래프를 구축할 수 있습니다.
- 2연구 세션 품질 예측개발자는 인텔리전스 레이어를 사용하여 특정 연구 작업의 품질이나 발생 가능한 오류를 예측할 수 있습니다.
- 3시맨틱 지식 검색사용자는 벡터 저장소를 사용하여 과거 연구 세션에 대해 시맨틱 검색을 수행할 수 있습니다.
- 4연구 결과 검증시스템은 여러 크리틱을 사용하여 캡처된 연구 데이터의 증거와 문맥을 검증합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
구성
COHERE_API_KEYRG_API_KEYRG_LOG_JSONRG_LOG_LEVELRG_SECRET_KEY
| 이름 | 설명 | 유형 |
|---|---|---|
| COHERE_API_KEY | — | |
| RG_API_KEY | — | |
| RG_LOG_JSON | — | |
| RG_LOG_LEVEL | — | |
| RG_SECRET_KEY | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능dicoangelo/researchgravity is public and reachablegithub.com/dicoangelo/researchgravity ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-25github.com/dicoangelo/researchgravity ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Why • What's New • Architecture • Quick Start • Auto-Capture • Sources • Contact
Proof Deck — See It Work
New local pilot: BASIX × ResearchGravity compares a bounded image-upscale workload, records source-backed decisions, and exports a selected handoff. Includes CLI, loopback UI, MCP tools and isolated SQLite indexing. See its validation and limits.
What's New in v6.1 — Security & Reliability (January 2026)
Production-hardened API with enterprise security.
| Feature | Description |
|---|---|
| 🔐 JWT Authentication | Token-based auth with /api/auth/token endpoint |
| ⏱️ Rate Limiting | slowapi integration (10/min search, 30/min write) |
| 🛡️ Input Validation | Path traversal prevention, session ID sanitization |
| 📝 Structured Logging | JSON/console formats with request context |
| 🔄 Dead-Letter Queue | Failed writes queued for retry with exponential backoff |
| ⚡ Async Cohere | Non-blocking embedding calls via asyncio.to_thread |
| 🔒 Connection Pool | Semaphore-guarded SQLite pool (race condition fix) |
Authentication
# Get JWT token
curl -X POST http://localhost:3847/api/auth/token \
-H "Content-Type: application/json" \
-d '{"client_id": "my-app", "scope": "write"}'
# Use token
curl -H "Authorization: Bearer <token>" http://localhost:3847/api/auth/me
# Or use API key
curl -H "X-API-Key: <your-api-key>" http://localhost:3847/api/v2/stats
Environment Variables
export RG_SECRET_KEY=$(python -c "import secrets; print(secrets.token_hex(32))")
export RG_API_KEY="your-service-api-key"
export RG_LOG_LEVEL="INFO" # DEBUG, INFO, WARNING, ERROR
export RG_LOG_JSON="true" # JSON format for production
What's New in v6.0 — Interactive Research Platform (January 2026)
From manual workflow to intelligent auto-capture. 3x faster research sessions with real-time URL capture.
| Feature | Description |
|---|---|
| 🎮 Interactive REPL | Real-time research CLI with Rich terminal UI |
| 🔄 Auto-Capture V2 | Automatic URL/finding extraction from Claude sessions (+70% capture rate) |
| 🧠 Intelligence Layer | CLI + API + REPL access to meta-learning predictions |
| 💾 sqlite-vec Storage | Local vector storage with FTS fallback (no external dependencies) |
| 👁️ File Watcher | Implicit session creation from Claude activity |
| 📊 Dual-Write Engine | Qdrant + sqlite-vec with automatic failover |
Interactive REPL
python3 scripts/session/repl.py
# Commands:
rg> start "multi-agent orchestration" # Initialize session
rg> url https://arxiv.org/... # Log URL (auto-classify)
rg> finding "Key insight about..." # Capture finding
rg> predict # Session quality prediction
rg> search "consensus algorithms" # Semantic search past sessions
rg> archive # Finalize session
Auto-Capture V2
python3 scripts/session/auto_capture_v2.py scan # Scan last 24 hours
python3 scripts/session/auto_capture_v2.py scan --hours 48
python3 scripts/session/auto_capture_v2.py status # Show capture stats
Intelligence CLI
python3 scripts/prediction/intelligence.py predict "task" # Session quality prediction
python3 scripts/prediction/intelligence.py optimal-time # Best hour for deep work
python3 scripts/prediction/intelligence.py errors "context" # Likely errors + prevention
python3 scripts/prediction/intelligence.py patterns # Session patterns
Intelligence API
| Endpoint | Method | Description |
|---|---|---|
/api/v2/intelligence/status |
GET | System capabilities |
/api/v2/intelligence/predict |
POST | Unified prediction |
/api/v2/intelligence/patterns |
GET | Session patterns |
/api/v2/intelligence/errors |
POST | Likely errors |
/api/v2/intelligence/feedback |
POST | Outcome feedback |
File Watcher
python3 scripts/session/watcher.py daemon # Start as background daemon
python3 scripts/session/watcher.py status # Check daemon status
python3 scripts/session/watcher.py stop # Stop daemon
Storage Modes
Priority: Qdrant → sqlite-vec → FTS fallback
- Qdrant: Full semantic search (requires server)
- sqlite-vec: Single-file vectors (offline capable)
- FTS: Full-text search fallback (always available)
Embedding Providers (SOTA 2026)
Priority: Cohere v4 → Cohere v3 → SBERT offline
Cohere embed-v4.0 (default):
- Multimodal (text + images)
- 128k context window
- Matryoshka dimensions: 256, 512, 1024, 1536
Dimension Options:
- 1536d: Maximum quality
- 1024d: Balanced (default)
- 512d: 50% storage savings
- 256d: 83% storage savings
Fallback Chain:
- Cohere v4 → Cohere v3 → SBERT (all-MiniLM-L6-v2)
Auto-switches on API failure. No manual configuration needed.
What's New in v5.0 — Chief of Staff (January 2026)
The AI Second Brain is now complete. Full infrastructure for sovereign knowledge management.
| Feature | Description |
|---|---|
| 🔮 Meta-Learning Engine | Predictive session intelligence from 666+ outcomes, 1,014 cognitive states |
| 🏛️ Storage Triad | SQLite (WAL mode, FTS5) + Qdrant (semantic search) |
| ⚖️ Writer-Critic System | 3 critics validate archives, evidence, and context packs |
| 🕸️ Graph Intelligence | 11,579 nodes, 13,744 edges — concept relationships & lineage |
| 🔌 REST API | 22 endpoints on port 3847 for cross-app integration |
| 📊 Oracle Consensus | Multi-stream validation for high-stakes outputs |
| 🎯 Evidence Layer | Citations, confidence scoring, source validation |
Chief of Staff Architecture
┌──────────────────────────────────────────────────────────────────────────────┐
│ CHIEF OF STAFF INFRASTRUCTURE │
├──────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ CAPTURE │───▶│ STORAGE │───▶│ INTELLIGENCE│───▶│ RETRIEVAL │ │
│ │ │ │ TRIAD │ │ │ │ API │ │
│ │ Sessions │ │ │ │ Writer │ │ │ │
│ │ URLs │ │ SQLite │ │ Critic │ │ REST /api/* │ │
│ │ Findings │ │ Qdrant │ │ Oracle │ │ Graph /v2 │ │
│ │ Transcripts │ │ Graph │ │ Evidence │ │ SDK │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ GRAPH INTELLIGENCE │ │
│ │ │ │
│ │ Sessions ──contains──▶ Findings ──cites──▶ Papers │ │
│ │ │ │ │ │ │
│ │ └──────enables─────────┴────derives_from───┘ │ │
│ │ │ │
│ │ 11,579 Nodes • 13,744 Edges • Concept Clusters • Lineage │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
v4.0 Features (Still Available)
| Feature | Description |
|---|---|
| 🧠 CPB Module | Cognitive Precision Bridge — 5-path AI orchestration |
| 🎯 ELITE TIER | 5-agent ACE consensus, Opus-first routing, 0.75 DQ bar |
| 📊 DQ Scoring | Validity (40%) + Specificity (30%) + Correctness (30%) |
| 🔀 Smart Routing | Auto-select path based on query complexity |
CPB Execution Paths
┌─────────────────────────────────────────────────────────────────────────┐
│ COGNITIVE PRECISION BRIDGE (CPB) │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ Query → [Complexity Analysis] → Path Selection → Execution → DQ Score │
│ │
│ ┌──────────┬──────────┬──────────┬──────────┬──────────┐ │
│ │ DIRECT │ RLM │ ACE │ HYBRID │ CASCADE │ │
│ │ <0.2 │ 0.2-0.5 │ 0.5-0.7 │ >0.7+ │ >0.7 │ │
│ │ Simple │ Context │ Consensus│ Combined │ Full │ │
│ │ ~1s │ ~5s │ ~5s │ ~10s │ ~15s │ │
│ └──────────┴──────────┴──────────┴──────────┴──────────┘ │
│ │
│ 5-Agent ACE Ensemble: │
│ 🔬 Analyst | 🤔 Skeptic | 🔄 Synthesizer | 🛠️ Pragmatist | 🔭 Visionary │
│ │
└─────────────────────────────────────────────────────────────────────────┘
🆕 CPB Precision Mode v2.0
Research-grounded answers with 95%+ quality target. Combines tiered search, grounded generation, and cutting-edge convergence research.
┌─────────────────────────────────────────────────────────────────────────┐
│ PRECISION MODE v2 PIPELINE │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ Query │
│ │ │
│ ▼ PHASE 1: TIERED SEARCH (ResearchGravity methodology) │
│ │ ├── Tier 1: arXiv, Labs, Industry News │
│ │ ├── Tier 2: GitHub, Benchmarks, Social │
│ │ └── Tier 3: Internal learnings (Qdrant) │
│ │ │
│ ▼ PHASE 2: CONTEXT GROUNDING │
│ │ └── Build citation-ready context (agents cite ONLY these) │
│ │ │
│ ▼ PHASE 3: GROUNDED CASCADE (7 agents) │
│ │ └── 🔬🤔🔄🛠️🔭📚💡 with citation enforcement │
│ │ │
│ ▼ PHASE 4: MAR CONSENSUS (Multi-Agent Reflexion) │
│ │ └── ValidityCritic + EvidenceCritic + ActionabilityCritic │
│ │ │
│ ▼ PHASE 5: TARGETED REFINEMENT (IMPROVE pattern) │
│ │ └── Fix weakest DQ dimension per retry │
│ │ │
│ ▼ PHASE 6: EDITORIAL FRAME │
│ │ └── Extract thesis / gap / innovation direction │
│ │ │
│ ▼ Result (DQ score + verifiable citations) │
│ │
└─────────────────────────────────────────────────────────────────────────┘
| Feature | Description |
|---|---|
| Tiered Search | arXiv API + GitHub API + Internal Qdrant |
| Time-Decay Scoring | Research: 23-day half-life, News: 2-day |
| Signal Quantification | Stars, citations, dates extracted |
| Grounded Generation | Agents can ONLY cite retrieved sources |
| MAR Consensus | 3 persona critics → synthesis (arXiv:2512.20845) |
| Targeted Refinement | IMPROVE pattern (arXiv:2502.18530) |
Usage:
python3 -m cpb precision "your research question" --verbose
v3.5 Changelog
| Feature | Description |
|---|---|
| Precision Bridge Research | Tesla US20260017019A1 → RLM synthesis methodology |
| Cognitive Wallet Tracking | 114 sessions, 2,530 findings, 8,935 URLs, 27M tokens |
| Deep Dive Workflow | Multi-paper synthesis with implementation output |
| Framework Extraction | COMPRESS → EXPLORE → RECONSTRUCT pattern identified |
Notable Research Sessions
| Session | Papers | Output |
|---|---|---|
| Chief of Staff Architecture | 374 | Storage Triad, Graph Intelligence, Writer-Critic |
| Tesla Mixed-Precision RoPE | 15 arXiv | recursiveLanguageModel.ts implementation |
| Multi-Agent Orchestration | 12 arXiv | ACE/DQ Scoring in OS-App |
| CPB Integration | 8 arXiv | cpb/ Python module |
| 160+ Papers Meta-Synthesis | 160+ | Unified research index |
What's New in v3.4
| Feature | Description |
|---|---|
| Context Prefetcher | scripts/session/prefetch.py — Inject relevant learnings into Claude sessions |
| Learnings Backfill | scripts/backfill/backfill_learnings.py — Extract learnings from all archived sessions |
| Memory Injection | Auto-load project context, papers, and lineage at session start |
| Shell Integration | prefetch, prefetch-clip, prefetch-inject shell commands |
v3.3 Changelog
| Feature | Description |
|---|---|
| YouTube Research | scripts/importers/youtube_channel.py — Channel analysis and transcript extraction |
| Enhanced Backfill | Improved session recovery with better transcript parsing |
| Ecosystem Sync | Deeper integration with Agent Core orchestration |
v3.2 Changelog
| Feature | Description |
|---|---|
| Auto-Capture | Sessions automatically tracked — URLs, findings, full transcripts extracted |
| Lineage Tracking | Link research sessions to implementation projects |
| Project Registry | 4 registered projects with cross-referenced research |
| Context Loader | Auto-load project context from any directory |
| Unified Index | Cross-reference by paper, topic, or session |
| Backfill | Recover research from historical Claude sessions |
Why ResearchGravity?
Traditional research workflows fail at the frontier:
| Problem | Impact |
|---|---|
| Single-source blindspots | Missing critical signals |
| No synthesis | Raw links ≠ research |
| No session continuity | Context lost between sessions |
| No quality standard | Inconsistent output |
ResearchGravity solves this with:
- Multi-tier source hierarchy — Tier 1 (primary), Tier 2 (amplifiers), Tier 3 (context)
- Cold Start Protocol — Never lose session context
- Synthesis workflow — Thesis → Gap → Innovation Direction
- Quality checklist — Consistent Metaventions-grade output
Architecture
Directory Structure
ResearchGravity/
│
├── api/ # REST API Server (v5.0+)
│ ├── server.py # FastAPI on port 3847 — 25 endpoints
│ └── routes/ # API route modules
│
├── capture/ # Event capture & normalization
├── chrome-extension/ # Browser extension for URL capture
├── cli/ # CLI Package (v6.0) — REPL commands & UI
│
├── coherence_engine/ # Cross-platform coherence detection
├── cpb/ # Cognitive Precision Bridge (v4.0)
├── critic/ # Writer-Critic validation system (v5.0)
├── dashboard/ # Web dashboard UI
├── delegation/ # Intelligent delegation (arXiv:2602.11865)
│
├── docs/ # All documentation
│ ├── context-packs/ # Context pack design & implementation docs
│ ├── meta-learning/ # Meta-learning architecture docs
│ ├── phases/ # Phase completion records
│ ├── prds/ # Product requirement documents
│ ├── routing/ # Routing workflow docs
│ └── ucw/ # UCW whitepaper & cognitive profile
│
├── graph/ # Graph Intelligence (v5.0) — 11K nodes
├── mcp_raw/ # MCP protocol & embeddings layer
├── methods/ # Research methodology definitions
├── notebooklm_mcp/ # NotebookLM MCP server (37 tools)
│
├── scripts/ # All utility scripts
│ ├── backfill/ # Backfill & migration (9 scripts)
│ ├── coherence/ # Coherence analysis pipeline
│ ├── context-packs/ # Context pack build/select/metrics
│ ├── evidence/ # Evidence extraction & validation
│ ├── importers/ # Platform importers (ChatGPT, Grok, CLI)
│ ├── prediction/ # Intelligence & prediction engine
│ ├── proof/ # Demo proof & interactive deck
│ ├── routing/ # Routing metrics & research sync
│ ├── session/ # Session management (status, init, REPL)
│ └── visual/ # Visual generation scripts
│
├── storage/ # Storage Engine — SQLite + Qdrant + sqlite-vec
├── tests/ # All test files
├── ucw/ # Universal Cognitive Wallet
├── webhook/ # Webhook event receiver
│
├── mcp_server.py # MCP server entry point
├── setup.sh # Bootstrap script
├── requirements.txt # Python dependencies
└── ruff.toml # Linter config
CPB Module (v4.0)
The Cognitive Precision Bridge provides precision-aware AI orchestration.
Quick Start
from cpb import cpb, analyze, score_response
# Analyze query complexity
result = analyze("Design a distributed cache system")
print(f"Complexity: {result['complexity_score']:.2f}")
print(f"Path: {result['selected_path']}")
# Build ACE consensus prompts (5 agents)
prompts = cpb.build_ace_prompts("What's the best auth strategy?")
for p in prompts:
print(f"[{p['agent']}] {p['system_prompt'][:50]}...")
# Score response quality
dq = score_response(query, response)
print(f"DQ: {dq.overall:.2f} (V:{dq.validity:.2f} S:{dq.specificity:.2f} C:{dq.correctness:.2f})")
CLI Commands
# Analyze query complexity
python3 -m cpb.cli analyze "Your query here"
# Score a response
python3 -m cpb.cli score --query "Q" --response "R"
# View DQ statistics
python3 -m cpb.cli stats --days 30
# Check CPB status
python3 -m cpb.cli status
# Via routing-metrics
python3 scripts/routing/routing-metrics.py cpb analyze "Your query"
python3 scripts/routing/routing-metrics.py cpb status
ELITE TIER Configuration
| Setting | Value | Description |
|---|---|---|
| Complexity Thresholds | 0.2 / 0.5 | Lower = more orchestration |
| ACE Agent Count | 5 | Full ensemble |
| DQ Quality Bar | 0.75 | Higher standard |
| Default Path | cascade | Full pipeline |
| RLM Iterations | 25 | Deeper decomposition |
| Model Routing | Opus-first | Maximum quality |
5-Agent ACE Ensemble
| Agent | Role | Focus |
|---|---|---|
| 🔬 Analyst | Evidence evaluator | Data, logic, consistency |
| 🤔 Skeptic | Challenge assumptions | Failure modes, risks |
| 🔄 Synthesizer | Pattern finder | Connections, frameworks |
| 🛠️ Pragmatist | Feasibility checker | Implementation, constraints |
| 🔭 Visionary | Strategic thinker | Long-term, second-order effects |
Research Foundation
- arXiv:2512.24601 (RLM) - Recursive context externalization
- arXiv:2511.15755 (DQ) - Decisional quality measurement (since withdrawn by its author; V+S+C formula adapted)
- arXiv:2508.17536 - Voting vs Debate consensus strategies
Installation
Prerequisites
- Python 3.12 (what CI builds and tests against)
- pip or pipenv
Setup
# Clone the repository
git clone https://github.com/Dicoangelo/ResearchGravity.git
cd ResearchGravity
# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate
# Install dependencies
pip install -r requirements.txt
Configuration
Create ~/.agent-core/config.json for API keys:
{
"cohere": {
"api_key": "your-cohere-api-key"
}
}
Or use environment variables:
export COHERE_API_KEY="your-cohere-api-key"
Optional (for API server):
export RG_SECRET_KEY=$(python -c "import secrets; print(secrets.token_hex(32))")
export RG_API_KEY="your-service-api-key"
Verify Installation
python3 scripts/session/status.py
ResearchGravity MCP 질문
오프라인에서도 사용할 수 있나요?
네, 단일 파일 벡터를 위한 sqlite-vec와 폴백용 FTS를 통해 오프라인 기능을 제공합니다.
어떤 임베딩 제공자를 사용할 수 있나요?
Cohere v4를 시작으로 Cohere v3, 그리고 오프라인 사용을 위한 SBERT (all-MiniLM-L6-v2) 순으로 폴백 체인을 사용합니다.