{"id":"mordechaipotash-brain-mcp","name":"brain-mcp","homepage":"https://brainmcp.dev","repo_url":"https://github.com/mordechaipotash/brain-mcp","category":"ai-ml","subcategories":[],"tags":["mcp","memory","context-engineering","personal-knowledge-management","semantic-search","vector-search","local-first","python"],"what_it_does":"brain-mcp is a local (on-device) MCP server plus CLI that imports an individual’s prior AI conversations, builds embeddings/summaries (optional), and exposes cognitive “tools” for searching, reconstructing context, and analyzing thinking history.","use_cases":["Reconstruct where you left off in a project/domain (open questions/decisions/next steps)","Search past conversations by meaning (semantic search)","Synthesize opinions/views you formed across many past chats","Trace how your thinking changed over time (trajectory)","Surface unfinished threads across domains","Provide quick stats/coverage/dashboard about what’s indexed","Assist with re-entry briefs after being away from a domain"],"not_for":["Storing or serving sensitive conversation history to third parties (it’s designed for local use, not sharing)","Use as a cloud SaaS memory platform with centralized accounts","Workflows requiring strong authenticated multi-tenant access control over a network API","Operations where you need guaranteed idempotent read/write semantics (the tool behavior for writes is not described)"],"best_when":"You want local, private “second brain” capabilities inside an AI desktop/client that can connect to an MCP server to query conversation history and summaries.","avoid_when":"You require formally specified REST/GraphQL contracts, documented retry/idempotency semantics, or you can’t control local storage/permissions for your conversation archives.","alternatives":["ChatGPT/Claude built-in memory (lightweight)","Local vector databases + an application wrapper (e.g., LanceDB/Chroma + custom RAG)","Other MCP memory/context projects (if available)","Personal knowledge management tools (Obsidian + embeddings/search) with an MCP bridge"],"af_score":57.2,"security_score":35.2,"reliability_score":25.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:25:08.953675+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Local usage; no network auth described for MCP server in README"],"oauth":false,"scopes":false,"notes":"README emphasizes 100% local/no accounts. No explicit authentication mechanism, tokens, or authorization model is documented for tool access."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing described; it appears to be self-hosted/local with optional use of external LLMs for summarization only via optional dependencies."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":["Local machine (no cloud dependency stated)"],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":57.2,"security_score":35.2,"reliability_score":25.0,"mcp_server_quality":75.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":90.0,"rate_limit_clarity":5.0,"tls_enforcement":20.0,"auth_strength":25.0,"scope_granularity":10.0,"dependency_hygiene":60.0,"secret_handling":70.0,"security_notes":"Security posture is largely local-first (no cloud accounts/depicted API), which reduces network exposure. However, explicit transport/authz details for the MCP server are not documented (likely runs locally without TLS/auth). Optional summarization dependencies may call external LLMs (per optional dependencies), which could introduce data egress depending on configuration. Dependency hygiene appears moderate from manifest but no CVE status is provided.","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":20.0,"error_recovery":35.0,"idempotency_support":"false","idempotency_notes":"Not documented whether operations are idempotent. Tools appear read-heavy (search/reconstruction), but setup/sync/ingestion behavior is not described with idempotency guarantees.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["README instructs assistants not to show tool names/technical details, but that’s guidance rather than a contract.","Progressive capability depends on whether summaries were generated; agents may see different output quality depending on indexing state.","Local sync behavior (mtime checks every ~60 seconds during tool calls) can change results mid-session if new files appear."]}}