AI 에이전트가 증거를 추적하고, 주장을 검증하며, 구조화된 워크플로우를 통해 연구 세션을 관리할 수 있는 로컬 연구 원장을 제공합니다.
다른 이름 grainulation/grainulator
- 스타
- 86
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 12일
- 라이선스
- MIT
Grainulator MCP란?
Grainulator은(는) MCP server입니다. AI 에이전트가 증거를 추적하고, 주장을 검증하며, 구조화된 워크플로우를 통해 연구 세션을 관리할 수 있는 로컬 연구 원장을 제공합니다.
프로젝트 README에서 생성된 요약
Grainulator MCP server 정보
Grainulator는 AI 에이전트가 증거를 추적하고, 주장을 검증하며, 복잡한 연구 세션을 관리할 수 있도록 설계된 로컬 연구 원장을 제공합니다. 모델이 발견 사항의 이력을 유지하고, 가설을 재검토하며, 추론 과정에서의 충돌을 감지할 수 있도록 돕는 구조화된 워크플로우 역할을 합니다. 이 시스템은 모델 지원 작업을 문서화된 출처에 기반하여 수행해야 하는 엔지니어와 연구자를 위해 구축되었습니다.
사용자는 npx를 이용한 MCP 연결이나 Claude Code 및 Codex용 전용 플러그인을 통해 서버에 연결할 수 있습니다. 또한 직접적인 상호작용을 위한 CLI도 제공합니다. 핵심 원장은 로컬에 저장되지만, 로컬로 구성된 프로바이더 계정을 사용하여 연구 플레이그라운드를 실행할 수 있습니다. 이 도구는 작업을 에이전트가 수행할 수 있는 자동 작업과 사람의 개입이 필요한 수동 작업의 두 가지 범주로 분류합니다. 이를 통해 연구 횟수나 주장 수에 제한을 두지 않으면서도 모든 연구 세션에서 명확한 진행 경로를 보장합니다.
활용 사례
- 1연구 결과 기록에이전트가 특정 주장과 그에 따른 증거 등급 및 출처를 기록하여 지속적인 원장을 유지할 수 있습니다.
- 2연구 무결성 검증수집된 데이터 내의 충돌, 취약한 근거 및 누락된 관점을 식별할 수 있습니다.
- 3연구 워크플로우 관리개발자가 에이전트에게 마이그레이션 조사를 지시하고, 증거를 기록하며, 다음 단계를 자동 및 수동 목록으로 나누도록 명령할 수 있습니다.
- 4중단된 세션 재개연구자가 세션을 중단하고 컨텍스트를 유지하여 나중에 작업을 이어서 진행할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능grainulation/grainulator is public and reachablegithub.com/grainulation/grainulator ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-12github.com/grainulation/grainulator ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기What it adds
Good models still need a way to keep track of evidence, revisit assumptions, and verify their work. Grainulator gives them that process, with a local ledger that stays with the task as it moves between models and sessions.
| Capability | What it gives you |
|---|---|
| Evidence that stays with the work | Typed claims, sources, evidence tiers, and provenance that survive edits and exports. |
| A check on the answer | Conflict detection, weak-support signals, and explicit gaps to investigate. |
| Clear next actions | Two lists: what the agent can continue automatically, and what needs your input. |
| Sessions you can carry forward | Configurable research, stop/resume, reusable context, and credential-free exports. |
| Verification for your task | A managed command loop that can use a verifier you provide. |
Grainulator works with Claude Code and Codex through plugins. It also provides a command-line tool and an MCP connection for other agents. You do not need to install its components separately.
Quick start
Requires Node.js 24+. Node 25 is the development default.
Upgrading from 1.x? Follow the migration checklist to update the plugin and keep your existing research data.
git clone --branch v2.2.0 https://github.com/grainulation/grainulator.git
cd grainulator
npm ci --ignore-scripts
node bin/grainulator.js doctor
To use Grainulator inside your agent, follow the Claude Code or Codex setup guide. The website shows a saved example of an evidence check. It does not send your question to a model.
The local research playground remains available through node bin/grainulator.js preview. It runs models using a provider account you configure locally.
Distribution: v2.2.0 is a GitHub release, not an npm registry release. For a separate local installation, follow the archive installation guide.
Other agents: connect through MCP
Add an MCP server that runs this command, with your project's absolute path:
npx -y github:grainulation/grainulator#v2.2.0 mcp --dir /absolute/path/to/project
Antigravity installs the full plugin. See the agent setup guide for Antigravity, Cursor and other MCP agents.
For the full Claude Code or Codex plugin, use the agent setup guide. Codex needs a project folder; the guide shows how to set it. CLI and direct MCP access remain available to other hosts.
Put it to work
With Grainulator connected, give your agent the outcome you need:
Use Grainulator to investigate whether we should migrate this service. Record the evidence, challenge the assumptions, implement the agreed changes, and verify them. Keep the remaining next steps split into Auto and Manual.
The work follows a simple cycle:
- Record findings with their sources and evidence tiers.
- Check for conflicts, weak support, and missing perspectives.
- Act on the gaps that matter, then verify the requested result.
- Continue from the saved ledger or export the session to another workflow.
There are no fixed claim-count or research-pass quotas. Auto lists work the agent can continue within your authorization. Manual lists decisions, access, or actions that need you. When you ask only for next steps, those two lists are the entire response.
node bin/grainulator.js init --dir ./sprints/migration \
--question 'Should we migrate this service?' \
--audience engineers --constraints 'Preserve existing user data' \
--done 'A verified plan with remaining risks documented'
node bin/grainulator.js add --dir ./sprints/migration \
--id r001 --type constraint --topic migration \
--content 'Existing user data must remain readable.' --evidence stated
node bin/grainulator.js compile --dir ./sprints/migration
The equivalent MCP tool is add_claim on the grainulator server. See the tool reference for evidence, memory, export, analytics, and orchestration operations.
Explore the docs
| Guide | Start here for… |
|---|---|
| Installation | Tagged source, isolated archives, and verified build identity. |
| Upgrading from 1.x | Host updates, renamed tools, existing data, and retired setup instructions. |
| Agent setup | Use Grainulator with Claude Code, Codex, or another agent. |
| Research sessions | Models, feature controls, credentials, export, and resume. |
| Tools | The canonical CLI and MCP interface. |
| Execution adapters | Attaching a model command and a task-specific verifier. |
| Architecture | The workspace layout and internal modules. |
| Evaluation | What has been measured and what remains unproven. |
| Contributing | Development setup, tests, and changes to the project. |
Verification and limits
CI checks Node 24 and 25, isolated package installation, plugin contracts, Rust runtime conformance, lint, and the static playground in a browser. Native host and live-provider acceptance have separate verification guides.
The compiler checks the structure and support recorded in the ledger; it does not establish that a source is true. Evaluations do not establish a general accuracy or efficiency gain, and per-pass limits are not a whole-session spending cap. Keep those distinctions when interpreting results.
npm test
npm run test:install
npm run lint
Browser and runtime prerequisites are in CONTRIBUTING.md. The offline node bin/grainulator.js demo exercises the adapter/verifier protocol without a provider account.
Grainulator MCP 질문
Grainulator가 출처의 진위 여부를 검증하나요?
아니요, 컴파일러는 원장에 기록된 구조와 근거를 확인하지만, 출처 자체의 진실성을 판별하지는 않습니다.
Claude Code와 함께 Grainulator를 사용할 수 있나요?
네, Grainulator는 플러그인을 통해 Claude Code와 함께 작동합니다.