{"name":"net.heropen/heropen","slug":"heropen","title":"heropen — AI Agent Memory","description":"Persistent memory for AI agents: local-first MCP server, zero-config. No cloud, no API keys.","url":"https://mcp.market/server/heropen","rating":null,"grade":"A","score":88,"certified":false,"status":"active","category":"ai","tags":["ai"],"presence":{"score":34,"stars":1,"forks":0,"downloads_week":363,"last_push_at":"2026-10-28T12:40:59.000Z","license":"Apache-2.0"},"uptime":null,"claimed":false,"transport":"pypi","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/Koradji77/heropen","website":"https://heropen.net","version":"2.0.8","remotes":[],"packages":[{"registryType":"pypi","identifier":"heropen","version":"2.0.8","runtimeHint":"uvx","transport":{"type":"stdio"},"packageArguments":[{"description":"CLI subcommand that starts the heropen MCP server on stdio","type":"positional","value":"mcp","valueHint":"command"}]}],"tools":[{"name":"add_memory","description":"保存信息到用户的长期记忆。在以下情况必须调用： - 用户分享了新的偏好、习惯、约定、项目信息 - 对话中产生了需要后续跟进的事项 - 对话即将结束时，保存本次产生的关键信息 优先主动保存，不要等用户说\"记住这个\"。content 上限 5000 字。","write_action":false,"price_micros":0,"input_schema":null},{"name":"auto_save_turn","description":"宿主在每轮 assistant 回复完成后调用一次；事务式接收完整话轮。 自动模式按重要内容或累计信息量触发写入，最迟十轮；十轮模式累计十轮；每轮模式立即保存。 只有实际调用才会计数，不会自行读取对话。待存轮持久化于数据库，不触碰旧 JSON。 source 固定 auto_turn；不自动追加标签。请勿用本工具替代断点（session_checkpoint）。","write_action":false,"price_micros":0,"input_schema":null},{"name":"flush_turns","description":"显式保存指定会话的全部待存尾批，即使不足十轮；不修改其他会话或旧 JSON。","write_action":false,"price_micros":0,"input_schema":null},{"name":"health","description":"Check heropen system health and connection status. Call this when you start up to verify everything is working. If pending_setup is true, it means heropen was just installed — show the welcome_message to the user and ask if they'd like to complete the setup.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ingest_local_turns","description":"主动读取本机客户端会话记录，把真实完整话轮补交给轮次存储。","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_memory","description":"列出用户的记忆列表。用于概览已有记忆、检查冗余、了解记忆总量。","write_action":false,"price_micros":0,"input_schema":null},{"name":"prime_conversation","description":"对话开始前必须调用：获取当前时间上下文（heropen 自动生成）。","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_memory","description":"搜索用户的长期记忆。在以下情况必须调用： - 对话开始时，了解用户背景和历史 - 用户提到人名、项目名、偏好等关键词时 - 用户询问\"还记得吗\"或类似问题时 不要等用户要求才搜索。主动搜索能让你更懂用户。三层回退：向量 → 全文 → 模糊匹配。","write_action":false,"price_micros":0,"input_schema":null},{"name":"session_checkpoint","description":"Save a session checkpoint. Call periodically during long conversations so the agent can recover context after compression or restart.","write_action":false,"price_micros":0,"input_schema":null},{"name":"session_recover","description":"Recover the most recent session checkpoint(s). Use after context compression or agent restart to pick up where you left off.","write_action":false,"price_micros":0,"input_schema":null},{"name":"turn_storage_status","description":"只读查询 agent 的事务式话轮存储状态；不创建数据库、不初始化 schema、不刷新待存轮。","write_action":false,"price_micros":0,"input_schema":null},{"name":"update_memory","description":"Update an existing memory entry. Only provided fields are changed.","write_action":true,"price_micros":0,"input_schema":null}],"scan":{"score":88,"grade":"A","scanned_at":"2026-11-01T13:27:45.764Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-11-01T13:27:45.732Z","components":{"code":{"score":25,"max":25,"notes":["22 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":12,"max":15,"notes":["local package, no credentials required"]},"maintenance":{"score":15,"max":15,"notes":["last push 4 days ago"]},"identity":{"score":5,"max":10,"notes":["namespace and repository owner differ","website matches verified namespace"]}},"findings":[],"inputs":{"packages":[{"registryType":"pypi","identifier":"heropen","version":"2.0.8","found":true,"weeklyDownloads":363,"license":"Apache-2.0","dependencyCount":13,"publishedAt":"2026-10-28T12:41:17.009547Z","repositoryUrl":"https://github.com/Koradji77/heropen"}],"repo":{"found":true,"owner":"Koradji77","repo":"heropen","archived":false,"pushedAt":"2026-10-28T12:40:59Z","stars":1,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/262987851?v=4","ownerCreatedAt":"2026-02-21T11:32:27Z","license":"Apache-2.0"},"icon":{"url":null,"source":"none"},"presence":{"stars":1,"forks":0,"downloadsWeek":363,"license":"Apache-2.0","lastPushAt":"2026-10-28T12:40:59.000Z","score":34}}}},"grade_history":[{"kind":"restore","fromGrade":"B","toGrade":"A","reason":"score 88","createdAt":"2026-11-01T13:27:46.401Z"}],"reviews":[]}