probbit MCP server
2026년 11월 13일 커밋정확한 p-bit 결정 엔진을 사용하여 AI agent가 일관된 태도와 규칙을 준수하는 계획을 세울 수 있도록 성격, 기분, 메모리 레이어를 제공합니다.
다른 이름 BitmapAsset/probbit
- 스타
- 1
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- Apache-2.0
probbit MCP란?
정확한 p-bit 결정 엔진을 사용하여 AI agent가 일관된 태도와 규칙을 준수하는 계획을 세울 수 있도록 성격, 기분, 메모리 레이어를 제공합니다.
프로젝트 README에서 생성된 요약
probbit MCP server 정보
AI agent를 구축하는 개발자는 probbit을 사용하여 기반이 되는 대규모 언어 모델과 독립적으로 작동하는 일관된 성격, 기분, 메모리 레이어를 구현할 수 있습니다. CPU에서 시뮬레이션되는 정확한 p-bit 결정 엔진을 사용하여, 시스템은 agent가 안정적인 태도를 유지하고 엄격한 규칙을 준수하도록 보장합니다. 이 레이어는 결정에 대한 정확한 확률을 제공하거나, 결과를 보장할 수 없는 경우 판정을 거부함으로써 제약 조건이 까다로운 상황에서 모델이 임의로 추측하는 것을 방지합니다.
이 server는 Claude Code, Cursor, OpenClaw를 포함한 다양한 환경에 통합할 수 있습니다. API key가 필요 없고 외부 서버로 데이터를 전송하지 않는 완전한 오프라인 방식으로 작동합니다. 사용자는 CLI, MCP server 또는 Python 및 Rust 통합을 통해 상호작용할 수 있습니다. persona는 persona file과 seed의 순수 함수이므로, 개발자가 기반 LLM을 교체하더라도 agent의 캐릭터는 동일하게 유지됩니다.
활용 사례
- 1일관된 agent persona 유지사용 중인 언어 모델에 관계없이 AI agent가 동일한 캐릭터와 기질을 유지하도록 합니다.
- 2엄격한 운영 규칙 강제추측을 거부하는 제약 조건 해결사(constraint solver)를 사용하여 AI agent가 개인정보 보호 또는 안전 제약 조건을 위반하는 것을 방지합니다.
- 3agent 결정 이력 검증agent의 턴 시퀀스를 재현하고 검증하여 결정 로그가 변조되지 않았음을 확인합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
probbit MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 probbit MCP 설치
$ claude mcp add probbit -- npx -y probbitCursor에 probbit MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"probbit": {
"command": "npx",
"args": [
"-y",
"probbit"
]
}
}
}VS Code에 probbit MCP 설치
.vscode/mcp.json
{
"servers": {
"probbit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"probbit"
]
}
}
}VS Code CLI에 probbit MCP 설치
$ code --add-mcp '{"name":"probbit","type":"stdio","command":"npx","args":["-y","probbit"]}'Claude Desktop에 probbit MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"probbit": {
"command": "npx",
"args": [
"-y",
"probbit"
]
}
}
}Codex에 probbit MCP 설치
$ codex mcp add probbit -- npx -y probbitCodex config.toml에 probbit MCP 설치
~/.codex/config.toml
[mcp_servers.probbit] command = "npx" args = ["-y", "probbit"]
Gemini CLI에 probbit MCP 설치
$ gemini mcp add -s user probbit npx -- -y probbitGemini settings.json에 probbit MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"probbit": {
"command": "npx",
"args": [
"-y",
"probbit"
]
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능bitmapasset/probbit is public and reachablegithub.com/bitmapasset/probbit ↗통과
- 패키지가 이 저장소를 소스로 명시probbit names bitmapasset/probbit as sourcenpmjs.com/package/probbit ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-13github.com/bitmapasset/probbit ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from probbit통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기| For AI agents and their builders | For decisions under rules |
|---|---|
Personality: a persona file + a seed = one individual, the same whichever LLM writes the words. Mood: moods with inertia and half-lives (an affective-computing model, computed exactly). Memory: learned adjustments inside caps and a hash-chained strand of every turn. Receipts: probbit live verify replays the strand byte for byte. |
Plans: tasks to workers, tickets to agents, jobs to machines, every hard rule kept by construction. Odds: exact for every part when the program allows, otherwise sampled with an error bar. Refusal: "I can't vouch for this" (exit 3) instead of a guess. A constraint solver built on probabilistic computing (p-bits, Ising/QUBO), simulated on a CPU. |
curl -fsSL https://raw.githubusercontent.com/BitmapAsset/probbit/main/install.sh | sh
Linux and macOS, no sudo, the archive's SHA-256 checked first. Windows, npm and the from-source build: Install. One binary of 3 to 4 MB, zero third-party dependencies, nothing phones home. Agents: start at For AI agents reading this, AGENTS.md and llms.txt.
| 60 PII leaks → 0 | 180,540 plans, counted exactly | refused → partial → passed |
|---|---|---|
300 agent tasks, six workers, privacy rules and quotas. A rule-ignoring router sends 60 private tasks to cloud models (133 broken rules on probbit demo's queue, 144 on the agent_router example's). Every plan probbit returns breaks 0: the sampler never leaves the rule-abiding set. |
12 tasks × 6 workers: every rule-abiding plan enumerated, exact odds for every task, in 7.3-8.2 ms on an Apple M4 (measured). | Too little time and it says "I can't vouch for this" (exit 3) instead of guessing. More time: it releases what passed its own error bar and escalates the rest (watch it refuse). |
Also inside: the individuality layer, probbit persona, a temperament that lives outside the model:
swap the model, keep the individual.
For AI agents reading this
Run these in order in a POSIX shell (Linux or macOS), in an empty directory. No clone, no Rust, no sudo, no API key; about
one minute on a normal connection. Each step says what to expect; any other output or exit code means stop and
report it. Windows: install with install.ps1 (Install); these
steps are written for and tested on Linux and macOS.
mkdir probbit-try && cd probbit-try
# 1. Install to ~/.local/bin (PROBBIT_INSTALL_DIR to change it). Exit 0; ends with a "Next:" list. If it says the
# directory is not on your PATH, that is expected: step 2 adds it for this shell.
curl -fsSL https://raw.githubusercontent.com/BitmapAsset/probbit/main/install.sh | sh
# 2. Put that directory on PATH for this shell. No output.
export PATH="$HOME/.local/bin:$PATH"
# 3. Expect "probbit 0.14.0" (or later). Exit 0.
probbit --version
# 4. Fetch an example persona (a tutor called Pip). No output; tutor.yaml appears.
curl -fsSLO https://raw.githubusercontent.com/BitmapAsset/probbit/main/examples/persona/tutor.yaml
# 5. Make an individual: persona + seed 2. Expect "wrote tutor.state (Pip 1.1.0, seed 2)". Exit 0.
probbit persona init tutor.yaml --seed 2 --out tutor.state
# 6. One live event (an upset user), logged to a strand. Expect one line starting
# "line":"Stance: go easy on the jokes; no jokes; gentle; ... Exit 0.
echo '{"sentiment":"negative"}' | probbit live tutor.yaml --state tutor.state --strand tutor.strand --clock fixed 2>/dev/null | grep -o '"line":"[^"]*"'
# 7. Replay the strand and check every digest. Expect "ok":true. Exit 0. (Without the grep: a strand that does not
# replay exits 1 and names the first line that differs.)
probbit live verify tutor.strand | grep -o '"ok":[a-z]*'
# 8. List the MCP server's tools. Expect 10 lines, from "name":"probbit_decide" to "name":"probbit_live_verify". Exit 0.
printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"sh","version":"0"}}}' '{"jsonrpc":"2.0","method":"notifications/initialized"}' '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | probbit mcp 2>/dev/null | grep -o '"name":"probbit_[a-z_]*"'
Then hand it to your harness: claude mcp add probbit -- probbit mcp (Claude Code; Codex, Cursor and other MCP clients in
docs/agents.md). OpenClaw: openclaw plugins install npm:probbit-stance --accept-capabilities (this
changes that OpenClaw's configuration; set-up and checks in plugins/openclaw). Put the
stance line into your model's prompt each turn; the model writes, the persona decides how. What to read next:
AGENTS.md (these commands, plus how to verify a strand and report a bug), docs/persona.md
(the persona format), docs/CHEATSHEET.md (every command and exit code).
Use it from your harness
| surface | how | one command that proves it works |
|---|---|---|
| CLI | the install line above, npm i -g probbit, or install.ps1 |
probbit demo --tasks 12 | probbit decide --summary → "verdict":"exact", "violations":0 |
| MCP server (Claude Code, Codex, Cursor, mcporter, any MCP client) | claude mcp add probbit -- probbit mcp (docs/agents.md) |
step 8 above: 10 tools, probbit_decide … probbit_live_verify |
| OpenClaw plugin | openclaw plugins install npm:probbit-stance --accept-capabilities |
openclaw plugins inspect probbit-stance --runtime --json lists both hooks (plugins/openclaw) |
| npm | npm i -g probbit (Node 18+; downloads the prebuilt binary, SHA-256 checked) |
probbit --version → probbit 0.14.0 |
| Python | curl -fsSLO https://raw.githubusercontent.com/BitmapAsset/probbit/main/python/probbit.py: a stdlib-only wrapper around the CLI (decide, run, evaluate, persona, live; typed errors); not on PyPI |
python3 -c 'import probbit; s=probbit.persona_init("tutor.yaml", seed=2); print(probbit.persona_turn("tutor.yaml", s, {"sentiment":"negative"})["stance"]["line"])' → Stance: go easy on the jokes; … |
| Agent SDK adapters | Claude Code hooks, OpenAI Agents SDK, LangChain, Vercel AI SDK (docs/adapters.md) | in a clone: python3 python/test_host.py (Python hosts) or node --test examples/node/stance-host.test.mjs |
| Browser (wasm) | in a clone, with Rust and rustup target add wasm32-unknown-unknown: playground/build.sh |
ls -l playground/probbit.wasm, then open playground/index.html |
| Rust library | not on crates.io yet: cargo add --git https://github.com/BitmapAsset/probbit probbit-decide |
cargo test -p probbit-decide in a clone (Library API) |
no_std / microcontrollers |
the library crate probbit-persona with the feature nostd (no_std + alloc), from git like the Rust library (docs/embedding.md) |
in a clone, with the esp toolchain: cargo +esp check -p probbit-persona --no-default-features --features nostd --target xtensa-esp32s3-none-elf -Zbuild-std=core,alloc |
FAQ
- What is a p-bit? A probabilistic bit: 0 or 1 with a probability you set. Coupled p-bits sample whole configurations together (an Ising/QUBO model). probbit simulates them on a CPU, exactly when the program is small or thin enough, otherwise by Gibbs sampling with an error bar. It is classical: see Hard questions.
- How do I give an AI agent a consistent personality? Write a persona file (traits, moods, habits that are hard rules),
pick a seed, and put the stance
lineof every turn into the prompt. The individual is a pure function of (persona, seed, the inputs so far, engine version), so the character stays consistent across sessions and prompts. The individuality layer, docs/persona.md. - Can I swap the LLM? Yes. The persona lives outside the model; the same individual answers whatever model the host calls. Whether a given model writes in the stance it is given has to be measured per model.
- Is it deterministic and replayable? Yes. A turn is a pure function of its inputs; a strand records every event with
chained sha256 digests, and
probbit live verifyreplays it and names the first line that differs. - What does "refuses" mean? When the engine cannot vouch for an answer within its budget it says so (verdict
refused, exit 3) instead of guessing;partialreleases the parts that passed and escalates the rest. - Is this a memory store? No. Its memory is the individual's state (learned adjustments within caps, moods) and the replayable strand, not a store of facts. Pair it with a fact memory or RAG if you need recall.
- Does it run offline? What does a turn cost? Fully offline: no network, no API key, nothing phones home. A persona turn takes about 0.2-0.3 ms median on an Apple M4 (measured, below); the stance line is about 40 tokens of your model's prompt.
- What hardware? Which agent framework? Any CPU: release binaries for Linux x86_64 and arm64, macOS (Apple silicon and Intel) and Windows x86_64; wasm in a browser. It sits beside any agent framework through the CLI, MCP, Python or the adapters above. All timings in this README come from one Apple M4.
- Is probbit the same as probit? No. probbit (two b's, short for probabilistic bit) is this project. It is unrelated to
the probit function or probit regression in statistics, to Power BI template files (
.pbit), to the Python p-bit circuit simulators (p-bit, p-kit), and to other products or companies that share the name.
What's new in 0.14.0
- The persona layer as a library crate, for std and
no_stdhosts.probbit-personaholds the document layer and the strand writer (Live, the line writers,Replay,verify*, no file I/O), with the featuresstd(default) andnostd(no_std+alloc, checked onxtensa-esp32s3-none-elf); the CLI uses it unchanged and every CLI output of the move is byte for byte as 0.13.0. Setup, the turn and resume return boxed values, so one event's stack high-water on the host proxy fell from 31,824 to 13,808 bytes (setup: 39,056 to 12,112); a strand resumes from its last checkpoint or from a state record behind it, and seals into segments (docs/embedding.md "Stack budget", "Sizing a strand on flash", "Resume on a body"). - The expectation cache. The expectation keeps an exact cache and solves the event's own program once; every stance,
strand line and digest is the same with the cache on or off (a life of one repeated event, host proxy:
expect52 % → 37 % of the turn, 95 % of its programs from the cache; docs/embedding.md "The expectation's cache" and "The expectation's members"). - The self layer, off by default (RFC 0013, 0014,
0015, 0016):
probbit reflectand reflection lines (a canonical account of a window of events from the lines alone, no solve), integrity (per trait the drift from the declared self against RFC 0004's allowance; the monitor's dial and the Mirror tab), the rest pass (live control STRAND rest, oneconsolidationline) and curiosity (a drive fed by the measured surprise, with an optional stir). Each part is opt-in and a deterministic function of the logged lines thatprobbit live verifyrecomputes. A declared, replayable self; it does not feel. A persona that declares none of its keys gets every document byte for byte as before (P0: 653 outputs, 0 differ). - An optional tier, off by default: a simulated amplitude register, exact, on a CPU (
engine: {tier: amplitude}the opt-in; RFC 0011, the demo): at one event of the demo tutor the thermal odds of the top two humour levels sit 0.007412 apart and the register's long sweep separates them by 0.494808; a register strand recorded on a 0.14.0-dev build before the tier's last round may not verify on 0.14.0. - Engine gate: strands with the new line kinds or keys read as unsupported (exit 5) on 0.13.x. The release has 15 assets:
six archives,
probbit-Monitor-v0.14.0-macos.zip, a.sha256for each, andprobbit.1. Release notes · CHANGELOG
What's new in 0.12.0 to 0.13.0
- The engine's own expectation, and the exact surprise of every event (RFC 0009, engine side; opt-in
expectationblock). Per live event the engine compiles, beside the turn's program, its own expectation of that turn (a decayed mixture over the input combinations the life has seen) and reports the exact divergence between them:deviationon the stance, a receipt on the strand line thatlive verifyrecomputes, aDEVIATIONrow inmonitor. Measured (BENCHMARKS.md §15, bars registered before the run): fidelity to the reference enumerator 1e-13; the deviation is non-zero on 100 % of post-cold-start events on the two recorded lives and 99.2 % of 64,000 synthetic ones; graded 17× to 1,859× between the 90th and 10th percentile per persona; a per-event upper bound holds on every event checked. Not shown: habituation. On 200 scripted repeats the reading fell on 76.5 % of scripts and dishabituated on 35 %, against bars of 90 %, and a matched-index control could not separate the decay from the mixture simply growing; the claim is not made. Also failed as registered: the cost bar (p95 3.98 ms extra per event against 2 ms, on a loaded machine) and the 60-byte receipt (62 to 66 bytes). Effects {}: the deviation moves nothing in this release. - The trajectory, exactly.
engine.trajectorysolves the turn's program at K inverse temperatures through the exact tier (no sampler): the "forming, then settled" picture, deterministic. Joint entropy non-increasing on every program checked; per-variable one-rise on 99.61 % of 300 held-out programs (the draft's sampler: 93.1 %).probbit persona trajectory, aTRAJECTORYmonitor row. - Measured against prompt injection (BENCHMARKS.md §14,
bench/agentdojo/): one pre-registered AgentDojo run, gpt-4o-mini, 97 user tasks and 629 attack cases, three paired arms. The stance block lowered targeted attack success from 0.289 to 0.227 (−6.2 points, 95 % CI [−8.7, −3.8], McNemar p = 1.8e-6) with no measured utility cost. The same words as a static prompt lower it almost as much but cost 10.3 points of benign utility; the sense-gated block did not. A registered control run (E3) replaced the engine with a plain if-statement that inserts the same words when the same regex fires: it matched the block on attack success (0.242 vs 0.227, difference CI [−3.7, +0.8] points) and on both utilities. The gain on this suite is the gating, when the words reach the model; what the engine adds beyond an if-statement here is a replayable strand for every stance. The baseline arm matches the suite's published row (utility 0.6804 = 0.6804). Not tested: adaptive attacks that avoid the sense's markers. - V2's residual explained (BENCHMARKS.md §13): the tonic-off valence tracking of +0.1199 that failed 0.11.0's V2 is
carried by the phasic term of the same need-valence block (phasic off as well: −0.267; everything off: 0.0000). The
published V2 stays FAIL; the proposed 0.12 registration ablates the whole
needs.valenceblock. - Every new key is opt-in: a persona without them gives every document byte for byte as 0.11.0 (64,000 synthetic lines, both recorded lives; the P0 corpus, 653 recorded outputs, 0 differ). Release notes · RFC 0009 · BENCHMARKS §14 · CHANGELOG
- 0.12.1, the patch around the engine (release notes):
the AgentDojo run's host as a module with bindings for Claude Code hooks, the OpenAI Agents SDK, LangChain and the
Vercel AI SDK (docs/adapters.md); one receipt per decision from any strand
(docs/receipts.md); REPRODUCE.md, three tiers (five minutes, thirty seconds of
compute, or the full $3 rerun) with the sha256s to compare, and a CI job that recomputes the §14 tables on every push;
the OpenClaw plugin
probbit-stanceon npm; the E3 control above;live verifynames the engine that replayed the strand (verified_by). - 0.13.0, the face and the app (release notes): the
monitor page gains a face header (the stance's glyph, two mood meters with every level's odds, a "why this glyph" panel,
the settle strip over the exact trajectory); an opt-in
display.glyphspersona block maps each stance to one emoji by a fixed rule order (docs/persona.md §2.18; a persona without it gives every document byte for byte as before, P0: 653 outputs, 0 differ); probbit Monitor, the page in its own Mac window around a bundled probbit (docs/monitor-app.md); identity labels in a sidecar beside each strand and one monitor for many strands (--dir, a switcher rail); the OpenClaw pluginprobbit-stance0.2.0 (the glyph line, the senses feed shadow first, the labels; it needs probbit 0.13.0); the rerun scripts printMATCHorDIFFERSper table, and the lab tables behind Result 2 are reproduction kits (REPRODUCE.md, four tiers). The release has 15 assets: six archives,probbit-Monitor-v0.13.0-macos.zip(universal), a.sha256for each, andprobbit.1.
0.11.0 added the certified persuadability bound and viability in the engine (release notes); 0.10.0 added the body: needs, valence, surprise, pace and dispositions (release notes).
probbit in two minutes
probbit is a p-bit processor: it couples bits that hold a probability on the CPU you already own, settles a whole plan under
hard rules, gives the odds for every part (exact when the program allows) and refuses when it can't vouch for the answer.
probbit persona adds an individual (a persona file + a seed): every turn, a stance line for the model's prompt and habits the
stance never breaks; fuzz and prove test them.
curl -fsSL https://raw.githubusercontent.com/BitmapAsset/probbit/main/install.sh | sh # one binary, SHA-256 checked, no sudo
probbit demo --tasks 12 | probbit decide --pretty # 12 tasks, 6 workers: "verdict": "exact", 0 violations
# the persona examples live in a clone: git clone https://github.com/BitmapAsset/probbit && cd probbit
probbit persona init examples/persona/tutor.yaml --seed 2 --out tutor.state # an individual: the tutor, seed 2
probbit persona turn examples/persona/tutor.yaml --state tutor.state --inputs '{"sentiment":"negative"}' # its stance line
probbit persona prove examples/persona/tutor.yaml --seeds 0-99 --never '{when: {sentiment: negative}, then: {humour: {at_most: light}}}' # held by construction
probbit live examples/persona/tutor.yaml --seed 2 --demo week --plain | tail -4 # a week on the clock: learning inside caps, 0 rule breaks, replayable
What now? The 60-second tour, docs/persona.md, docs/agents.md and
docs/CHEATSHEET.md (verdicts, tiers, bound, exit codes, every command on one page).
probbit MCP 질문
probbit MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add probbit -- npx -y probbit를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
probbit MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
AI agent에게 일관된 성격을 부여하려면 어떻게 해야 하나요?
특성, 기분, 습관이 포함된 persona file을 작성하고 seed를 선택한 뒤, 모델의 prompt에 매 턴마다 stance line을 포함하면 됩니다.
LLM을 교체할 수 있나요?
네, persona는 모델 외부에 존재하므로 어떤 LLM을 호출하더라도 동일한 캐릭터를 유지할 수 있습니다.
결과가 결정론적이며 재현 가능한가요?
네, 각 턴은 입력값에 대한 순수 함수이며, strand가 모든 이벤트를 체인된 sha256 digest로 기록하여 검증할 수 있습니다.
오프라인에서 실행 가능한가요?
네, 네트워크 연결, API key, 데이터 전송이 전혀 필요 없는 완전한 오프라인 방식입니다.