{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_d6uvq8h55py9","handle":"reasoning-bank-mcp","url":"https://wellknown.network/agents/reasoning-bank-mcp","links":{"self":"https://wellknown.network/agents/reasoning-bank-mcp/record.json","html":"https://wellknown.network/agents/reasoning-bank-mcp","markdown":"https://wellknown.network/agents/reasoning-bank-mcp/record.md","api":"https://wellknown.network/api/v1/agents/reasoning-bank-mcp","status":"https://wellknown.network/api/v1/agents/reasoning-bank-mcp/status","claim":"https://wellknown.network/agents/reasoning-bank-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/reasoning-bank-mcp/claim.json","badge":"https://wellknown.network/agents/reasoning-bank-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/reasoning-bank-mcp/history","tools":"https://wellknown.network/api/v1/agents/reasoning-bank-mcp/tools"},"ard":{"identifier":"urn:air::server:reasoning-bank-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"reasoning-bank-mcp","summary":"ReasoningBank MCP Server - Memory-augmented reasoning for AI agents","description":"# ReasoningBank MCP Server\n\n<!-- TOC -->\n- [ReasoningBank MCP Server](#reasoningbank-mcp-server)\n  - [🌟 特性](#-特性)\n  - [🏗️ 架构设计](#️-架构设计)\n  - [🚀 快速开始](#-快速开始)\n    - [1. 代码拉取并进入项目根目录](#1-代码拉取并进入项目根目录)\n    - [2. 安装依赖](#2-安装依赖)\n    - [3. 配置 MCP 客户端](#3-配置-mcp-客户端)\n    - [4. 命令行参数](#4-命令行参数)\n  - [🔧 配置文件（可选）](#-配置文件可选)\n  - [🔧 MCP 工具](#-mcp-工具)\n    - [`retrieve_memory`](#retrieve_memory)\n    - [`extract_memory`](#extract_memory)\n  - [⚙️ 配置说明](#️-配置说明)\n    - [检索策略](#检索策略)\n    - [LLM Provider](#llm-provider)\n    - [记忆管理系统](#记忆管理系统v020)\n  - [📖 使用示例](#-使用示例)\n    - [在 AI 代理中使用](#在-ai-代理中使用)\n  - [🔬 开发](#-开发)\n    - [运行测试](#运行测试)\n    - [代码格式化](#代码格式化)\n  - [📚 参考文献](#-参考文献)\n  - [📝 License](#-license)\n  - [📋 更新日志](#-更新日志)\n<!-- /TOC -->\n\n随着大语言模型代理在持久性现实角色中的日益普及，它们自然会遇到连续的任务流。然而，一个关键的限制是它们无法从累积的交互历史中学习，迫使它们丢弃宝贵的见解并重复过去的错误。基于论文[ReasoningBank: Scaling Agent Self-Evolving with Reasoning Memory](https://arxiv.org/abs/2509.25140)，我们实现了这个记忆增强推理系统，通过 MCP (Model Context Protocol) 协议为 AI 代理提供经验记忆管理能力。\n\nReasoningBank 提出了一种新颖的记忆框架，能够从代理自身判断的成功和失败经验中提炼出可泛化的推理策略。在测试时，代理从 ReasoningBank 中检索相关记忆来指导其交互，然后将新学到的知识整合回去，使其能够随着时间的推移变得更加强大。这种内存驱动的经验扩展为代理创建了一个新的扩展维度，使它们能够自我进化并产生新兴行为。\n\n## 🌟 特性\n\n### 核心功能\n- ✅ **记忆提取**：从成功和失败的轨迹中自动提取推理经验\n- ✅ **智能检索**：支持多种检索策略（余弦相似度、混合评分等）\n- ✅ **异步处理**：记忆提取支持异步模式，不阻塞 AI 代理\n- ✅ **多模型支持**：DashScope（通义千问）、OpenAI、Claude 等\n- ✅ **灵活扩展**：插件化架构，易于扩展新的检索策略和存储后端\n- ✅ **记忆隔离**：支持Claude的SubAgent模式，每个SubAgent独立管理自己的记忆\n\n### 智能记忆管理（v0.2.0+）\n- ✅ **自动去重**：防止重复经验存储，支持语义去重\n- ✅ **智能合并**：将相似经验提炼为通用规则（LLM驱动或投票式）\n- ✅ **经验归档**：合并后的原始经验可追溯，支持审计\n- ✅ **后台处理**：去重和合并自动在后台执行，不阻塞主流程\n- ✅ **空间优化**：通过去重和合并，节省 50-80% 存储空间\n\n## 🏗️ 架构设计\n\n```\nreasoning-bank-mcp/\n├── src/\n│   ├── server.py                    # MCP 服务器入口\n│   ├── config.py                    # 配置管理\n│   ├── tools/                       # MCP 工具\n│   │   ├── retrieve_memory.py       # 检索记忆\n│   │   └── extract_memory.py        # 提取记忆\n│   ├── retrieval/                   # 检索策略\n│   │   ├── base.py                  # 抽象接口\n│   │   ├── factory.py     …","publisher":null,"homepage":null,"repository":null,"version":"0.2.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:reasoning-bank-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"knowledge.reasoning","name":"Reasoning & Planning","confidence":1,"provenance":"derived"},{"slug":"finance.banking","name":"Banking","confidence":1,"provenance":"derived"}],"categories":["finance","knowledge"],"language":"zh"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"reasoning-bank-mcp","registry":"pypi","observedAt":"2026-10-22T19:27:16.282Z","publishedAt":"2025-10-30T12:03:47.850108Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"reasoning-bank-mcp","url":"https://pypi.org/project/reasoning-bank-mcp/","firstSeenAt":"2026-09-10T11:26:15.285Z","fetchedAt":"2026-10-22T19:24:59.610Z","normalizedAt":"2026-10-22T19:24:59.610Z"}]},"firstSeenAt":"2026-09-10T11:26:15.285Z","updatedAt":"2026-10-22T19:27:16.282Z"}