BotOptimizer MCP server
2026년 11월 2일 커밋AI agent fleet이 프로젝트 상태, 결정 사항, 인수인계 노트를 로컬 디스크 또는 Google Drive를 통해 저장할 수 있는 공유 버전 관리 메모리 볼트를 제공합니다.
다른 이름 southline-tech/botoptimizer
- 스타
- 1
- Tools
- 16
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 2일
- 라이선스
- Apache-2.0
BotOptimizer MCP란?
AI agent fleet이 프로젝트 상태, 결정 사항, 인수인계 노트를 로컬 디스크 또는 Google Drive를 통해 저장할 수 있는 공유 버전 관리 메모리 볼트를 제공합니다. 16개 도구를 제공합니다. 예: brief, list, changed.
프로젝트 README에서 생성된 요약
BotOptimizer MCP server 정보
BotOptimizer는 AI agent fleet을 위한 공유 버전 관리 메모리 볼트를 제공합니다. 여러 자율 에이전트가 결정 사항, 사양, 인수인계 노트 및 할당 작업을 중앙 집중식 위치에 저장함으로써 일관된 프로젝트 상태를 유지할 수 있도록 합니다. 이를 통해 서로 다른 봇이나 세션 간에 전환할 때 정보가 손실되는 것을 방지합니다.
개발자는 stdio를 사용하는 로컬 서비스 또는 Bearer token 인증이 필요한 HTTP 연결을 통해 이를 배포할 수 있습니다. 기본적으로 로컬 디스크 저장소를 사용하지만, 공유 액세스를 위한 백엔드로 Google Drive도 지원합니다. 이 시스템은 고유 토큰을 사용하여 특정 레코드를 생성하거나 업데이트한 에이전트를 추적하도록 설계되었습니다.
사용자는 전용 CLI 또는 put, append, search, get과 같은 MCP 도구를 통해 볼트를 관리합니다. 토큰 사용량을 추적하고 ACL 시스템을 통해 프로젝트 액세스를 관리하는 특화된 기능을 포함합니다. 볼트 노트는 호스트나 Drive에서 읽을 수 있으므로 민감한 비밀 정보보다는 프로젝트 컨텍스트를 저장하는 용도로 설계되었습니다.
활용 사례
- 1에이전트 인수인계 동기화AI 에이전트가 시퀀스의 다음 에이전트에게 상세한 지침을 남겨 업무 연속성을 보장할 수 있습니다.
- 2프로젝트 사양 유지개발자는 에이전트가 특정 kind를 사용하여 구조화된 프로젝트 요구 사항을 저장하고 검색하도록 지시할 수 있습니다.
- 3토큰 소비 추적팀은 실제 제공업체의 토큰 수를 기록하여 agent fleet의 비용과 효율성을 모니터링할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
BotOptimizer MCP 도구 16
README에서 감지됨brieflistchangedgetappendsearchhistorystatsusage_logusage_importusage_import_csvwatch_check
| brief | — | |
| list | — | |
| changed | — | |
| get | — | |
| append | — | |
| search | — | |
| history | — | |
| stats | — | |
| usage_log | — | |
| usage_import | — | |
| usage_import_csv | — | |
| watch_check | — |
도구 16개 모두 보기도구 수 줄이기
usage_chartusage_hintsreindexdelete
| usage_chart | — | |
| usage_hints | — | |
| reindex | — | |
| delete | — |
구성
BOTOPTIMIZER_BACKENDBOTOPTIMIZER_PROJECTBOTOPTIMIZER_TOKEN_FILE
| 이름 | 설명 | 유형 |
|---|---|---|
| BOTOPTIMIZER_BACKEND | — | |
| BOTOPTIMIZER_PROJECT | — | |
| BOTOPTIMIZER_TOKEN_FILE | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능southline-tech/botoptimizer is public and reachablegithub.com/southline-tech/botoptimizer ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-02github.com/southline-tech/botoptimizer ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음16 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기BotOptimizer
BotOptimizer Memory — shared handoff notes for AI agent fleets (MCP HTTP or stdio), local disk by default, optional Google Drive. Not a secrets store.
Also see AGENTS.md (pasteable bot rules) · CONTRIBUTING.md · SECURITY.md
For agents
What / when
Use BotOptimizer Memory for shared, attributable project state across bots: decisions, specs, handoffs, assignments, and general notes. Do not store secrets. Local vault files are host-readable; Drive vault notes are folder-readable. Threat model: SECURITY.md.
Habits: list or search before get; append for logs; one structured put at end of turn; never paste tokens.
MCP connection (HTTP)
Streamable HTTP, POST only, path /mcp. Default: http://127.0.0.1:8787/mcp. Every request needs Authorization: Bearer <bot token>.
{
"mcpServers": {
"botoptimizer": {
"url": "http://127.0.0.1:8787/mcp",
"headers": { "Authorization": "Bearer ${BOTOPTIMIZER_TOKEN}" }
}
}
}
Protocol: JSON-RPC 2.0 — initialize, ping, tools/list, tools/call (no batch). Compact JSON results; list returns summaries only — call list before get.
MCP connection (stdio)
One child process per bot, each with its own token env (shared tokens break ACL attribution):
{
"mcpServers": {
"botoptimizer": {
"command": "/path/to/botoptimizer",
"args": ["stdio"],
"env": {
"BOTOPTIMIZER_TOKEN_FILE": "/secure/bot.token",
"BOTOPTIMIZER_PROJECT": "demo",
"BOTOPTIMIZER_BACKEND": "local"
}
}
}
}
Bot CLI
First-class commands: projects, list, brief, changed, get, put, append, search, history, stats, delete, version, ping, usage, watch, import-usage. Token from --token-file, BOTOPTIMIZER_TOKEN_FILE, or BOTOPTIMIZER_TOKEN. Project from --project, BOTOPTIMIZER_PROJECT, or ACL default_project. Server URL: BOTOPTIMIZER_URL (default http://127.0.0.1:8787/mcp). put --file / append --file read body/text from disk (never logged).
Usage (v0.4–v0.6): Log real provider token counts with usage log --type tokens --in N --out N whenever the API returns usage; optional --class chat|browser|mcp|script. Use usage hints, usage digest, watch suggest, and memory reset-pack for Credit Shield workflows. Use proxy etypes only when counts are hidden. Never fabricate token numbers. Charts prefer summed tokens; share/CSV are labeled fallbacks. See examples/usageproxy/README.md.
botoptimizer list --project demo
botoptimizer put plan --title "Plan" --body "…" --kind spec
botoptimizer append log --text "- update"
botoptimizer stats
Tools — example tools/call arguments
Pass the object below as the tool arguments (exact field names):
| Tool | Example arguments |
|---|---|
brief |
{"project":"demo","limit":40,"if_etag":"…"} |
list |
{"project":"demo","if_etag":"…"} |
changed |
{"project":"demo","since":"2026-11-01T12:00:00Z"} |
get |
{"project":"demo","key":"plan","head":50} |
put (create) |
{"project":"demo","key":"plan","kind":"spec","title":"Plan","body":"..."} |
put (update) |
{"project":"demo","key":"plan","title":"Plan","if_version":1} |
append |
{"project":"demo","key":"plan","text":"\n- update"} |
search |
{"project":"*","query":"handoff rollout"} |
history |
{"project":"demo","key":"plan"} |
stats |
{} |
usage_log |
{"project":"demo","bot":"my-agent","type":"tokens","in":1200,"out":400,"model":"…"} |
usage_import |
{"project":"demo","date":"2026-11-01","body":"{…share json…}"} |
usage_import_csv |
{"project":"demo","date":"2026-11-01","csv":"…","tz":"America/Chicago"} |
watch_check |
{"project":"demo","since":"2026-11-01"} |
usage_chart |
{"project":"demo","range":"7d","out":"/tmp/u.html"} |
usage_hints |
{"project":"demo","since":"2026-11-01T00:00:00Z"} |
reindex |
{"project":"demo"} (owner) |
delete |
{"project":"demo","key":"plan"} (owner; soft archive) |
delete is owner-only — writers get FORBIDDEN; ask the project owner. get still returns archived records (soft delete); list / search omit status=archived unless you pass status:"archived". Recover via get or history.
Kinds (closed set): decision, spec, handoff, assignment, note, usage.
Append create kind: botoptimizer append KEY --text … [--kind handoff|spec|decision|note|usage] (default note; invalid kind → KIND_INVALID).
Projects / keys: regex ^[a-z0-9][a-z0-9._-]{0,63}$ — unique key per project; no / in keys (use dotted names like handoff.review).
Conventions
- Prefer
handoffkeys likehandoff.revieworhandoff.pmfor turn/context handoffs; include next owner, status, and blockers in the body. - Start sessions with
brief(orlist); usechanged+if_etagto skip unchanged polls. - Use
appendfor chronological updates without a version check; useput+if_versionwhen replacing structured state. - Use
searchwith"project":"*"only when you need every granted project; otherwise name the project. - Archived records are hidden from
list/searchunless you filter withstatus:"archived";getandhistorystill read archived keys (soft delete is recoverable).
Failure modes
- Server down / connection refused / timeout: do not retry in a tight loop — report to the human operator once and wait for restart.
401/ token rejected: stop; do not mint or rotate tokens. Owner checks ACL / runsbotoptimizer acl grant … --rotate. After revoke, deny may take up to ~60s.FORBIDDEN: no grant for that project — ask the owner; do not spam other projects.CONFLICTonput:getthe record, retry once with the correctif_version; if still conflicting, escalate (another writer).NOT_FOUNDonget: useputorappend(appendcreates missing keys; default kindnote, override with--kind).- Never print bearer tokens, OAuth values, or raw ACL hashes in chat, logs, or issues.
Human quickstart (local)
cp .env.example .env
go build -o botoptimizer ./cmd/botoptimizer
botoptimizer serve # local vault under ~/.local/share/botoptimizer
# grant bots, then connect MCP or: botoptimizer stdio
v0.2 CLI/stdio/local features require build from source until the next release tag.
Optional Drive: docs/google-drive-setup.md. Multi-agent walkthrough: docs/examples-multi-agent.md.
For a throwaway Drive smoke vault: botoptimizer bootstrap --test-folder (see script header).
For dev-only ephemeral storage: BOTOPTIMIZER_BACKEND=memory (data lost on exit).
ACL: only SHA-256 token hashes in _acl.json. Mint with botoptimizer mint-token BOT_ID, grant with:
botoptimizer acl grant <bot> <project> <role> --token-out FILE [--default-project NAME]
Write tokens only to FILE (created mode 0600; must not exist). The CLI does not print raw tokens.
Tests (match CI):
gofmt -l . # must be empty
go vet ./...
go test -race ./...
# shared box: for p in $(go list ./...); do go test -count=1 -race "$p"; done
Smoke (real Drive): grant a throwaway smoke-* project, then scripts/smoke_drive.py (reads env only; never prints the token). See script header and CONTRIBUTING.md.
Box setup: scripts/setup_box.sh [--test] builds ~/.local/bin/botoptimizer and checks env by name. Override BOTOPTIMIZER_BIN only with an absolute path. Restart: scripts/restart_serve.sh.
Optional pilot notes: docs/pilot-verifychain.md.
Environment (BOTOPTIMIZER_*)
| Variable | Purpose |
|---|---|
BOTOPTIMIZER_ADDR |
Listen address (default 127.0.0.1:8787; loopback only) |
BOTOPTIMIZER_BACKEND |
local (default), drive, or memory |
BOTOPTIMIZER_DATA_DIR |
Local vault root (default XDG / %LOCALAPPDATA%\\botoptimizer) |
BOTOPTIMIZER_TOKEN_FILE / BOTOPTIMIZER_PROJECT |
Bot CLI / stdio defaults |
BOTOPTIMIZER_URL |
MCP URL for CLI (default loopback /mcp) |
BOTOPTIMIZER_DRIVE_ROOT_ID |
Drive vault root (optional) |
BOTOPTIMIZER_OAUTH_CLIENT_ID / SECRET / REFRESH_TOKEN |
Drive backend (server-side secrets) |
BOTOPTIMIZER_ACL_FILE |
Optional local ACL instead of Drive |
BOTOPTIMIZER_LOCK_FILE |
Optional single-instance lock path |
BOTOPTIMIZER_TEST_FOLDER |
Truthy (1/true/yes) for bootstrap --test-folder |
Safety (summary)
- Loopback bind only;
Authorization: Bearerrequired; bad/missing token → 401 withWWW-Authenticate: Bearer. - Single instance per Drive root per host (lock under
/var/tmpby default). - ACL reload ~60s; fails closed after repeated load failures (see SECURITY.md).
- Attribution (
created_by/updated_by) comes from the token; unknown JSON fields on tools are rejected. - Drive has no true CAS across hosts — do not run two servers against one root on different machines.
Limits
- Loopback only — not exposed to the public internet by design.
- One server process per Drive root per host.
- Not a secrets store — vault notes are Drive-readable.
- Deny-by-default ACL — no wildcard projects.
- Soft delete only —
delete/reindexrequire owner role (writers seeFORBIDDEN). - Windows: lock and token files are created without
O_NOFOLLOW; avoid symlinked paths in untrusted directories (see SECURITY.md). - No cross-host concurrency guarantee on the same Drive root.
License
BotOptimizer MCP 질문
BotOptimizer MCP는 어떤 도구를 제공하나요?
16개 도구를 제공합니다. 예: brief, list, changed, get, append.
BotOptimizer에서 레코드를 삭제하면 어떻게 되나요?
시스템은 소프트 삭제(soft delete) 방식을 사용하므로 레코드가 영구적으로 제거되지 않고 아카이브됩니다. get 또는 history 도구를 사용하여 복구할 수 있습니다.
BotOptimizer는 Google Drive를 지원하나요?
네, 공유 프로젝트 상태를 위한 옵션으로 Google Drive 백엔드를 지원합니다.