Agentmemorymcp

Agent内存MCP

AgentMemoryMCP是一个。用于MCP服务器的NET 10工作区，为AI代理提供持久的本地内存和会话连续性。

包含MCP工具

这 AgentSession.MCP 服务器目前提供以下工具：

• list_agent_sessions
• create_or_activate_session
• read_agent_memory
• append_agent_memory
• log_agent_event
• create_agent_artifact
• read_agent_artifact
• list_agent_artifacts
• save_final_plan
• get_latest_final_plan

工具使用快速流程

对于大多数代理工作流，请按以下顺序使用工具：

1. 可选发现：调用 list_agent_sessions 检查现有会话。
2. 开始或继续：致电 create_or_activate_session 在任何多步骤工作之前。
3. 再水合上下文：调用 read_agent_memory 在恢复之前的工作时。
4. 持续不断变化的上下文：调用 append_agent_memory 为了持久的事实和 log_agent_event 可追踪的行动。
5. 使用可重用的输出：调用 create_agent_artifact, read_agent_artifact，以及 list_agent_artifacts.
6. 敲定计划：致电 save_final_plan 坚持最新的最终计划版本。
7. 稍后恢复计划上下文：致电 get_latest_final_plan 获取最新保存的计划。

存储库结构

• AgentSession.MCP/：主MCP服务器项目，包括工具、服务、模型和存储逻辑。
• AgentSession.MCP.Tests/：服务、存储和工具行为的测试项目。
• Prompts/：开发过程中使用的提示和工作流注释。
• AgentMemoryMCP.slnx：解决方案入口点。

合同（短期）

工具请求/响应合同分为以下几类：

• AgentSession.MCP/Contracts/Requests/
• AgentSession.MCP/Contracts/Responses/
• AgentSession.MCP/Contracts/Items/

这些DTO定义了工具处理程序使用的面向MCP的有效载荷。

快速开始

运行MCP服务器：

dotnet run --project AgentSession.MCP/AgentSession.MCP.csproj

构建解决方案：

dotnet build AgentMemoryMCP.slnx

运行测试：

dotnet test AgentSession.MCP.Tests/AgentSession.MCP.Tests.csproj

打包MCP服务器：

dotnet pack AgentSession.MCP/AgentSession.MCP.csproj -c Release

将MCP服务器发布到本地文件夹：

dotnet publish AgentSession.MCP/AgentSession.MCP.csproj -c Release -o ./publish

存储布局

默认本地存储根目录：

• %USERPROFILE%/AgentMemory/sessions

每个会话文件：

• //agent_session_state.yaml
• //agent_memory.md
• //agent_session_log.yaml
• //artifacts/*.md

工件是带有YAML前端元数据的markdown文件。

文档

有关工具合同、存储布局和使用示例，请参阅：

• AgentSession.MCP/README.md
• Prompts/MCP_For_Agent_Session.md
• Prompts/PlanSavingTools.md