Skip to content

Python: [Feature]: Add a Python sample for local bitemporal memory over MCP #7168

Description

@ebeirne

Description

Agent Framework already demonstrates MCPStdioTool and several memory providers, but it does not show a local MCP memory server with point-in-time recall and explicit stale-fact supersession.

I propose a single Python sample under python/samples/02-agents/mcp that launches the published Lians MCP server with uvx, attaches it through MCPStdioTool, and demonstrates three operations: remember a dated fact, supersede it with a later revision, and query what the agent knew at an earlier decision time.

This would demonstrate an existing Agent Framework extension surface rather than add a new API or package. The sample would use PEP 723 metadata, require no Lians account or API key in local mode, and add no root development dependency.

I am a Lians maintainer and would contribute the sample. I will keep the copy factual and clearly identify Lians as a third-party project.

Alternatives considered:

  • Add a new Agent Framework connector package. This is unnecessary because MCPStdioTool already provides the integration surface.
  • Add only a link in documentation. A runnable sample is more useful and easier to validate.
  • Target AutoGen. AutoGen now directs feature development to Agent Framework.

Code Sample

async with (
    MCPStdioTool(
        name="lians_memory",
        command="uvx",
        args=["--from", "lians-sdk[mcp]", "lians-mcp"],
    ) as memory,
    Agent(client=client, tools=memory) as agent,
):
    result = await agent.run(
        "Remember that guidance was 40 on January 1, revise it to 45 on February 1, "
        "then report what was known on January 15."
    )

Language/SDK

Python

Metadata

Metadata

Assignees

No one assigned

    Labels

    pythonUsage: [Issues, PRs], Target: PythontriageUsage: [Issues], Target: All issues that still need to be triaged

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    Status
    No status

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions