Clude Memory MCP

Category: Data & AI | Uploader: sebbsssss | Downloads: 0 | Version: v1.0（Latest）

MCP server for Clude's 4-tier cognitive memory system — store, recall, search, and dream. Built on Supabase + pgvector with type-specific decay, Hebbian association graphs, and on-chain commitment via Solana.

Changelog: Source: GitHub https://github.com/sebbsssss/cludebot

Directory Structure

Current level: Root

📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.md 669 B
  - 📄 feature_request.md 399 B
- 📁 workflows/
  - 📄 ci.yml 570 B
  - 📄 publish.yml 615 B
  - 📄 telegram-notify.yml 1.4 KB
- 📄 PULL_REQUEST_TEMPLATE.md 378 B
📁 .paperclip/
- 📁 logs/
  - 📄 server.log 23.0 KB
📁 dashboard/
- 📁 public/
  - 📄 vite.svg 1.5 KB
- 📁 src/
  - 📁 assets/
    
    📄 react.svg 4.0 KB
  - 📁 components/
    
    📄 Layout.module.css 2.0 KB
    
    📄 Layout.tsx 2.0 KB
  - 📁 hooks/
    
    📄 AuthContext.ts 720 B
    
    📄 useAuth.ts 3.2 KB
  - 📁 lib/
    
    📄 api.ts 6.0 KB
    
    📄 export-markdown.ts 3.0 KB
  - 📁 pages/
    
    📄 BrainView.tsx 5.3 KB
    
    📄 Dashboard.tsx 6.5 KB
    
    📄 DecayHeatmap.tsx 6.4 KB
    
    📄 EntityMap.tsx 9.8 KB
    
    📄 Landing.tsx 6.4 KB
    
    📄 MemoryPacks.tsx 10.7 KB
    
    📄 Settings.tsx 7.1 KB
    
    📄 Timeline.tsx 8.0 KB
  - 📁 types/
    
    📄 memory.ts 2.1 KB
  - 📄 App.css 606 B
  - 📄 App.tsx 1.4 KB
  - 📄 index.css 1.4 KB
  - 📄 main.tsx 1.2 KB
- 📄 .env.example 67 B
- 📄 .gitignore 38 B
- 📄 eslint.config.js 616 B
- 📄 index.html 364 B
- 📄 package-lock.json 440.7 KB
- 📄 package.json 789 B
- 📄 tsconfig.app.json 732 B
- 📄 tsconfig.json 119 B
- 📄 tsconfig.node.json 653 B
- 📄 vite.config.ts 161 B
📁 docs/
- 📄 INTEGRATION.md 5.4 KB
- 📄 MOLECULAR_MEMORY.md 6.0 KB
📁 examples/
- 📄 basic-memory.ts 1.6 KB
- 📄 chat-agent.ts 2.3 KB
- 📄 hosted-mode.ts 2.0 KB
- 📄 progressive-disclosure.ts 1.5 KB
📁 migrations/
- 📄 002_memory_vector_upgrade.sql 3.9 KB
- 📄 003_batch_operations.sql 1.2 KB
- 📄 003_entities.sql 3.0 KB
- 📄 003_hash_ids_and_compaction.sql 1.9 KB
- 📄 004_memory_links.sql 4.0 KB
- 📄 005_importance_rescoring.sql 441 B
- 📄 006_hnsw_index.sql 1.4 KB
- 📄 007_venice_stats.sql 442 B
- 📄 008_match_memories_filter_owner.sql 1.2 KB
- 📄 009_owner_isolation.sql 2.2 KB
📁 programs/
- 📁 memory-registry/
  - 📁 src/
    
    📁 instructions/
    
    📄 initialize.rs 808 B
    
    📄 mod.rs 146 B
    
    📄 register_memory.rs 1.6 KB
    
    📄 verify_memory.rs 814 B
    
    📄 errors.rs 382 B
    
    📄 lib.rs 1.2 KB
    
    📄 state.rs 1.8 KB
  - 📄 Cargo.toml 330 B
📁 scripts/
- 📁 .locomo-cache/
  - 📄 locomo10.json 2.7 MB
  - 📄 results.json 997.4 KB
- 📄 benchmark.ts 20.9 KB
- 📄 locomo-benchmark.ts 24.2 KB
- 📄 post-tweet.js 591 B
- 📄 postinstall.js 15.6 KB
- 📄 re-embed-memories.ts 4.3 KB
📁 src/
- 📁 agents/
  - 📄 executor.ts 13.1 KB
  - 📄 index.ts 345 B
  - 📄 tools.ts 10.2 KB
  - 📄 types.ts 7.3 KB
- 📁 character/
  - 📄 agent-tier-modifiers.ts 610 B
  - 📄 base-prompt.ts 1.2 KB
  - 📄 mood-modifiers.ts 650 B
  - 📄 tier-modifiers.ts 565 B
- 📁 cli/
  - 📄 banner.ts 2.5 KB
  - 📄 export.ts 13.4 KB
  - 📄 import.ts 13.2 KB
  - 📄 index.ts 4.0 KB
  - 📄 init.ts 20.5 KB
  - 📄 register.ts 3.5 KB
  - 📄 setup.ts 15.7 KB
  - 📄 ship.ts 1.1 KB
  - 📄 status.ts 9.2 KB
  - 📄 sync.ts 5.2 KB
- 📁 core/
  - 📄 allium-client.ts 6.0 KB
  - 📄 claude-client.ts 7.7 KB
  - 📄 database.ts 21.0 KB
  - 📄 embeddings.ts 7.8 KB
  - 📄 encryption.ts 4.5 KB
  - 📄 guardrails.ts 7.6 KB
  - 📄 inference.ts 5.0 KB
  - 📄 input-guardrails.ts 2.3 KB
  - 📄 logger.ts 986 B
  - 📄 memory-graph.ts 17.6 KB
  - 📄 memory.ts 61.4 KB
  - 📄 owner-context.ts 1.0 KB
  - 📄 price-oracle.ts 5.5 KB
  - 📄 solana-client.ts 11.3 KB
  - 📄 telegram-client.ts 3.4 KB
  - 📄 venice-client.ts 11.6 KB
  - 📄 x-client.ts 13.1 KB
- 📁 events/
  - 📄 event-bus.ts 1.3 KB
  - 📄 handlers.ts 655 B
- 📁 features/
  - 📄 action-learning.ts 16.1 KB
  - 📄 active-reflection.ts 14.7 KB
  - 📄 agent-tier.ts 2.0 KB
  - 📄 campaign-tracker.ts 7.1 KB
  - 📄 clinamen.ts 7.5 KB
  - 📄 dream-cycle.ts 36.4 KB
  - 📄 market-monitor.ts 6.0 KB
  - 📄 memory-trace.ts 15.8 KB
  - 📄 onchain-opinion.ts 2.8 KB
  - 📄 price-personality.ts 6.2 KB
  - 📄 x-sentiment-monitor.ts 11.8 KB
- 📁 knowledge/
  - 📄 tokenomics.ts 4.2 KB
- 📁 mcp/
  - 📄 local-store.ts 9.0 KB
  - 📄 server.ts 16.5 KB
- 📁 mentions/
  - 📄 classifier.ts 1.6 KB
  - 📄 dispatcher.ts 17.1 KB
  - 📄 poller.ts 1.3 KB
- 📁 sdk/
  - 📄 cortex-v2.ts 10.3 KB
  - 📄 cortex.ts 14.1 KB
  - 📄 http-transport.ts 1.6 KB
  - 📄 index.ts 473 B
  - 📄 sdk-mode.ts 163 B
  - 📄 types.ts 2.1 KB
- 📁 services/
  - 📄 response.service.ts 3.0 KB
  - 📄 social.service.ts 1.7 KB
  - 📄 telegram.service.ts 3.0 KB
- 📁 types/
  - 📄 api.ts 2.3 KB
- 📁 utils/
  - 📄 constants.ts 6.3 KB
  - 📄 env-persona.ts 1.2 KB
  - 📄 format.ts 1.4 KB
  - 📄 index.ts 79 B
  - 📄 text.ts 948 B
- 📁 verify-app/
  - 📁 public/
    
    📁 preview/
    
    📄 brain.html 36.8 KB
    
    📄 index-light.html 21.0 KB
    
    📄 index.html 21.0 KB
    
    📄 memory-flow-2d.html 6.8 KB
    
    📄 memory-flow.html 12.4 KB
    
    📁 samples/
    
    📄 defi-trader.json 367.4 KB
    
    📄 research-agent.json 619.6 KB
    
    📄 support-agent.json 436.2 KB
    
    📄 agents.md 3.5 KB
    
    📄 benchmark-report.html 44.1 KB
    
    📄 benchmark.html 67.0 KB
    
    📄 brain.html 67.4 KB
    
    📄 campaign.html 61.8 KB
    
    📄 compare.html 16.6 KB
    
    📄 dashboard.html 59.5 KB
    
    📄 demo.html 31.0 KB
    
    📄 docs.html 65.3 KB
    
    📄 explore.html 86.5 KB
    
    📄 favicon.svg 3.5 KB
    
    📄 graph.html 10.8 KB
    
    📄 index.html 47.1 KB
    
    📄 infographic.html 12.0 KB
    
    📄 install.html 15.8 KB
    
    📄 journal.html 16.1 KB
    
    📄 pitch.html 26.8 KB
    
    📄 portability.html 10.6 KB
    
    📄 privacy.html 19.5 KB
    
    📄 register.html 23.0 KB
    
    📄 setup.html 39.8 KB
    
    📄 trace.html 39.8 KB
  - 📄 .DS_Store 8.0 KB
  - 📄 routes.ts 2.7 KB
- 📁 webhook/
  - 📄 agent-routes.ts 12.9 KB
  - 📄 campaign-routes.ts 11.7 KB
  - 📄 cortex-routes.ts 21.1 KB
  - 📄 dashboard-routes.ts 21.0 KB
  - 📄 graph-routes.ts 7.6 KB
  - 📄 privy-auth.ts 3.2 KB
  - 📄 server.ts 33.4 KB
- 📄 .DS_Store 8.0 KB
- 📄 config.ts 4.3 KB
- 📄 index.ts 5.6 KB
📄 .DS_Store 14.0 KB
📄 .env.example 675 B
📄 .gitignore 65 B
📄 .mcp.json 255 B
📄 .npmignore 105 B
📄 .redeploy 11 B
📄 Anchor.toml 400 B
📄 CHANGELOG.md 5.0 KB
📄 clude-memories.json 789.6 KB
📄 CONTRIBUTING.md 2.1 KB
📄 Dockerfile 484 B
📄 entity-graph-schema.sql 5.7 KB
📄 LICENSE 1.0 KB
📄 package-lock.json 115.2 KB
📄 package.json 2.3 KB
📄 pitch-script.md 3.5 KB
📄 railway.toml 128 B
📄 README.md 21.3 KB
📄 SKILL.md 2.4 KB
📄 supabase-schema.sql 15.4 KB
📄 test-memory-pack.json 28.9 KB
📄 tsconfig.json 441 B
📄 tsconfig.sdk.json 621 B

SKILL.md

---
name: Clude Memory MCP
description: MCP server for Clude's 4-tier cognitive memory system — store, recall, search, and dream. Built on Supabase + pgvector with type-specific decay, Hebbian association graphs, and on-chain commitment via Solana.
metadata:
  openclaw:
    requires:
      env:
        - SUPABASE_URL
        - SUPABASE_SERVICE_KEY
      bins:
        - node
    primaryEnv: SUPABASE_URL
---

# Clude Memory MCP

MCP server exposing a 4-tier cognitive memory architecture inspired by Stanford's Generative Agents (Park et al. 2023).

## Tools

### `recall_memories`
Search the memory system. Returns scored memories ranked by relevance, importance, recency, and vector similarity.

- `query` — text to search against memory summaries
- `tags` — filter by tags
- `related_user` — filter by user/agent ID
- `memory_types` — filter by type: `episodic`, `semantic`, `procedural`, `self_model`
- `limit` — max results (1-20, default 5)
- `min_importance` — minimum importance threshold (0-1)

### `store_memory`
Store a new memory. Memories persist across conversations, decay over time if not accessed, and get committed to Solana.

- `type` — `episodic` (events), `semantic` (knowledge), `procedural` (behaviors), `self_model` (identity)
- `content` — full memory content
- `summary` — short summary for recall matching
- `tags` — tags for filtering
- `importance` — importance score 0-1
- `source` — origin identifier (e.g. `mcp:my-agent`)

### `get_memory_stats`
Get statistics: counts by type, average importance/decay, dream session history, top tags.

### `get_market_mood`
Get current market mood and price state (no LLM call).

### `ask_clude`
Ask Clude a question and get an in-character response. Calls Claude API.

## Setup

```bash
npm install clude-bot
```

Requires a Supabase project with the schema from `supabase-schema.sql`. Set `SUPABASE_URL` and `SUPABASE_SERVICE_KEY` environment variables.

## Architecture

- **4-tier memory**: episodic (7%/day decay), semantic (2%/day), procedural (3%/day), self_model (1%/day)
- **Hybrid retrieval**: pgvector cosine similarity + keyword matching + tag scoring
- **Dream cycles**: consolidation, reflection, emergence — every 6 hours
- **On-chain commitment**: SHA-256 hashed memories committed to Solana via memo transactions
- **Granular decomposition**: per-fragment embeddings for precise sub-memory retrieval

## License

MIT

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

Clude Memory MCP

Directory Structure

SKILL.md

Report

Notice