AIエージェントが証拠の追跡、主張の検証、および構造化されたワークフローを通じたリサーチセッションの管理を行うための、ローカルなリサーチ台帳を提供します。
別名 grainulation/grainulator
- スター
- 86
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月12日
- ライセンス
- MIT
Grainulator MCPとは
GrainulatorはMCPサーバーです。 AIエージェントが証拠の追跡、主張の検証、および構造化されたワークフローを通じたリサーチセッションの管理を行うための、ローカルなリサーチ台帳を提供します。.
プロジェクトのREADMEから生成された概要
Grainulator MCP server について
Grainulatorは、AIエージェントが証拠を追跡し、主張を検証し、複雑なリサーチセッションを管理できるように設計されたローカルなリサーチ台帳を提供します。これは、モデルが調査結果の履歴を保持し、仮定を再検討し、推論における矛盾を検出できるようにする構造化されたワークフローとして機能します。このシステムは、モデルによる作業が文書化されたソースに基づいていることを保証する必要があるエンジニアや研究者向けに構築されています。
ユーザーは、npxを使用したMCP接続、またはClaude CodeやCodex用の専用プラグインを介してサーバーに接続できます。また、直接操作するためのCLIも提供されています。コアとなる台帳はローカルに保持されますが、ローカルに設定されたプロバイダーアカウントを使用してリサーチプレイグラウンドを実行できます。このツールは、タスクを「エージェントが実行できる自動アクション」と「人間の介入を必要とする手動アクション」の2つの明確なカテゴリに整理します。これにより、リサーチの回数や主張の数に固定の制限を設けることなく、すべてのリサーチセッションにおいて明確な進め方を確保します。
できること
- 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と連携できます。