Fournit un registre de recherche local permettant aux agents IA de suivre les preuves, de vérifier les affirmations et de gérer des sessions de recherche via un flux de travail structuré.
Aussi connu sous grainulation/grainulator
- Étoiles
- 86
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 12 nov. 2026
- Licence
- MIT
Qu'est-ce que Grainulator MCP ?
Fournit un registre de recherche local permettant aux agents IA de suivre les preuves, de vérifier les affirmations et de gérer des sessions de recherche via un flux de travail structuré.
Résumé généré à partir du README du projet
À propos du MCP server Grainulator
Grainulator propose un registre de recherche local conçu pour aider les agents IA à suivre les preuves, vérifier les affirmations et gérer des sessions de recherche complexes. Il fonctionne comme un flux de travail structuré qui permet aux modèles de maintenir un historique des découvertes, de revoir leurs hypothèses et de détecter les conflits dans leur raisonnement. Le système est conçu pour les ingénieurs et les chercheurs qui ont besoin de garantir que leur travail assisté par modèle reste ancré dans des sources documentées.
Les utilisateurs peuvent se connecter au serveur via une connexion MCP en utilisant npx, ou par le biais de plugins dédiés pour Claude Code et Codex. Il propose également une interface en ligne de commande pour une interaction directe. Bien que le registre principal soit local, un environnement de recherche peut être exécuté à l'aide d'un compte fournisseur configuré localement. L'outil organise les tâches en deux catégories distinctes : les actions automatiques que l'agent peut effectuer et les actions manuelles nécessitant une intervention humaine. Cela garantit une progression claire pour chaque session de recherche sans imposer de quotas fixes sur le nombre de passages de recherche ou d'affirmations.
Ce que vous pouvez faire avec
- 1Documenter les résultats de rechercheUn agent peut enregistrer des affirmations spécifiques ainsi que leurs niveaux de preuve et leurs sources afin de maintenir un registre persistant.
- 2Vérifier l'intégrité de la rechercheLe système peut identifier les conflits, les preuves insuffisantes et les perspectives manquantes au sein des données collectées.
- 3Gérer les flux de travail de rechercheUn développeur peut ordonner à un agent d'étudier une migration, d'enregistrer les preuves et de diviser les prochaines étapes en listes automatiques et manuelles.
- 4Reprendre des sessions interrompuesLes chercheurs peuvent interrompre une session et conserver le contexte pour poursuivre le travail ultérieurement.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblegrainulation/grainulator is public and reachablegithub.com/grainulation/grainulator ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-12github.com/grainulation/grainulator ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubWhat 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.
Questions sur Grainulator MCP
Est-ce que Grainulator vérifie si une source est vraie ?
Non, le compilateur vérifie la structure et les preuves enregistrées dans le registre, mais il ne détermine pas la véracité d'une source.
Puis-je utiliser Grainulator avec Claude Code ?
Oui, Grainulator fonctionne avec Claude Code via des plugins.