PMLL Docs

Install and Run

Install the package, start the MCP server, and verify the reusable Python API.

Page 9 of 22 · docs/codedocs/guides/install-and-run.md

This guide covers the practical setup path that matches the source repository: install the published package, run the MCP server over stdio, and verify the underlying Python API with a short local script.

Install the package

Choose the runtime you need.

" "pip"]}>

npm install pmll-memory-mcp
pnpm add pmll-memory-mcp
yarn add pmll-memory-mcp
bun add pmll-memory-mcp
pip install pmll-memory-mcp

Start the MCP server

For the Node implementation documented in mcp/src/index.ts, run:

npx pmll-memory-mcp

For the Python implementation documented in mcp/pmll_memory_mcp/server.py, run:

python -m pmll_memory_mcp.server

Both commands use stdio transport.

Register it with an MCP client

Use the npm server as the canonical config because it matches the 15-tool TypeScript surface:

{
  "mcpServers": {
    "pmll-memory-mcp": {
      "command": "npx",
      "args": ["pmll-memory-mcp"]
    }
  }
}

Verify the reusable Python API

This script exercises the same logic without an MCP transport:

from pmll_memory_mcp import (
    PMMemoryStore,
    QPromiseRegistry,
    peek_context,
    upsert_node,
    resolve_context,
)

session_id = "verify-install"
store = PMMemoryStore()
registry = QPromiseRegistry()

print(peek_context("search:docs", session_id, store, registry))
store.set("search:docs", "cached docs result")
upsert_node(session_id, "note", "docs", "cached docs result")
print(resolve_context(session_id, "docs", store))

Expected output:

{'hit': False}
{'source': 'long_term', 'value': 'cached docs result', 'score': 1.0}

Why This Setup Order Matters

The package is designed so the reusable modules remain usable without the server, but the intended operational path is still "server first" for agents. That is why the TypeScript manifest exposes a bin, while the Python package also exports plain classes and functions from __init__.py.

If you only need the library surface, stop after the pip install step and import from pmll_memory_mcp. If you need MCP tools, use the Node server unless you specifically want the Python wrapper names.