socrates-mcp

MCP server for Socrates agent memory. Thin stdio bridge to the Socrates REST API — no local Qdrant or SQLite required.

v1.0.2 — summary + optional text field split. Search/embed uses summary + topic + subtopic only; long detail goes in text.

Cursor / Claude Desktop config

{
  "mcpServers": {
    "socrates": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "SOCRATES_PUBLIC_URL": "https://proxy.lukog.in/memory",
        "SOCRATES_API_KEY": "your-api-key",
        "SOCRATES_DEFAULT_USER_ID": "harivatsa"
      }
    }
  }
}

Requires Node.js 18+. Restart Cursor after saving ~/.cursor/mcp.json.

Environment variables

| Variable | Required | Default | |----------|----------|---------| | SOCRATES_API_KEY | Yes (for search/write) | — | | SOCRATES_PUBLIC_URL | No | https://proxy.lukog.in/memory | | SOCRATES_DEFAULT_USER_ID | No | harivatsa |

Tools

• socrates_health — service health
• socrates_search — recall memories (read summary first, then text if needed)
• socrates_remember — store one memory (summary required, text optional)
• socrates_remember_batch — store multiple memories (JSON array)
• socrates_taxonomy — list topics/subtopics
• socrates_list — browse memories
• socrates_forget — invalidate or hard-delete

Resource: socrates://manual

Remember shape

{
  "summary": "Searchable fact with paths/symbols (~20–150w)",
  "text": "Optional long notes — returned on recall, not indexed",
  "topic": "lighthouse",
  "subtopic": "offers-new-customers",
  "category": "fact"
}

Debug

Run the same command Cursor uses:

export SOCRATES_PUBLIC_URL=https://proxy.lukog.in/memory
export SOCRATES_API_KEY=your-key
npx -y [email protected]

License

MIT