alaya-mcp 0.2.1 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +77 -0
- package/package.json +10 -6
package/README.md
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# alaya-mcp
|
|
2
|
+
|
|
3
|
+
A local memory engine for AI agents. Stores conversation episodes, consolidates knowledge through a neuroscience-inspired lifecycle, and builds a personal knowledge graph — all in a local SQLite database.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
### Claude Code
|
|
8
|
+
|
|
9
|
+
Add to `~/.claude/claude_code_config.json`:
|
|
10
|
+
|
|
11
|
+
```json
|
|
12
|
+
{
|
|
13
|
+
"mcpServers": {
|
|
14
|
+
"alaya": {
|
|
15
|
+
"command": "npx",
|
|
16
|
+
"args": ["-y", "alaya-mcp"]
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
### Claude Desktop
|
|
23
|
+
|
|
24
|
+
Add to your Claude Desktop MCP config:
|
|
25
|
+
|
|
26
|
+
```json
|
|
27
|
+
{
|
|
28
|
+
"mcpServers": {
|
|
29
|
+
"alaya": {
|
|
30
|
+
"command": "npx",
|
|
31
|
+
"args": ["-y", "alaya-mcp"],
|
|
32
|
+
"env": {
|
|
33
|
+
"ALAYA_LLM_API_KEY": "sk-...",
|
|
34
|
+
"ALAYA_LLM_API_URL": "https://api.openai.com/v1/chat/completions",
|
|
35
|
+
"ALAYA_LLM_MODEL": "gpt-4o-mini"
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
The `ALAYA_LLM_*` env vars are optional — they enable automatic knowledge extraction. Without them, the agent extracts knowledge from its own context.
|
|
43
|
+
|
|
44
|
+
## MCP Tools
|
|
45
|
+
|
|
46
|
+
| Tool | Description |
|
|
47
|
+
|------|-------------|
|
|
48
|
+
| `remember` | Store a conversation episode |
|
|
49
|
+
| `recall` | Semantic search across memories |
|
|
50
|
+
| `status` | Memory system health and stats |
|
|
51
|
+
| `knowledge` | Browse extracted knowledge |
|
|
52
|
+
| `learn` | Store pre-extracted facts and relationships |
|
|
53
|
+
| `categories` | View emergent category taxonomy |
|
|
54
|
+
| `preferences` | Track crystallized user preferences |
|
|
55
|
+
| `neighbors` | Explore the knowledge graph |
|
|
56
|
+
| `lifecycle` | Trigger maintenance (strengthen, transform, forget) |
|
|
57
|
+
| `configure` | Set embedding provider and other options |
|
|
58
|
+
|
|
59
|
+
## How It Works
|
|
60
|
+
|
|
61
|
+
1. **Remember** — store conversation episodes as they happen
|
|
62
|
+
2. **Consolidate** — extract facts, relationships, and concepts from episodes
|
|
63
|
+
3. **Strengthen** — frequently accessed memories grow stronger (Bjork model)
|
|
64
|
+
4. **Categorize** — emergent categories form automatically from your knowledge
|
|
65
|
+
5. **Forget** — weak, unused memories fade naturally over time
|
|
66
|
+
|
|
67
|
+
All data stays on your machine in `~/.alaya/memory.db`.
|
|
68
|
+
|
|
69
|
+
## Links
|
|
70
|
+
|
|
71
|
+
- [GitHub](https://github.com/SecurityRonin/alaya)
|
|
72
|
+
- [Documentation](https://docs.rs/alaya)
|
|
73
|
+
- [crates.io](https://crates.io/crates/alaya) (Rust library)
|
|
74
|
+
|
|
75
|
+
## License
|
|
76
|
+
|
|
77
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "alaya-mcp",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.2",
|
|
4
4
|
"description": "Alaya MCP Server — a memory engine for AI agents that remembers, forgets, and learns",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -17,20 +17,24 @@
|
|
|
17
17
|
"README.md"
|
|
18
18
|
],
|
|
19
19
|
"optionalDependencies": {
|
|
20
|
-
"@alaya-mcp/cli-linux-x64": "0.2.
|
|
21
|
-
"@alaya-mcp/cli-darwin-arm64": "0.2.
|
|
22
|
-
"@alaya-mcp/cli-darwin-x64": "0.2.
|
|
23
|
-
"@alaya-mcp/cli-win32-x64": "0.2.
|
|
20
|
+
"@alaya-mcp/cli-linux-x64": "0.2.2",
|
|
21
|
+
"@alaya-mcp/cli-darwin-arm64": "0.2.2",
|
|
22
|
+
"@alaya-mcp/cli-darwin-x64": "0.2.2",
|
|
23
|
+
"@alaya-mcp/cli-win32-x64": "0.2.2"
|
|
24
24
|
},
|
|
25
25
|
"scripts": {
|
|
26
26
|
"postinstall": "node scripts/postinstall.js"
|
|
27
27
|
},
|
|
28
28
|
"keywords": [
|
|
29
29
|
"mcp",
|
|
30
|
+
"mcp-server",
|
|
31
|
+
"claude",
|
|
30
32
|
"memory",
|
|
33
|
+
"knowledge-graph",
|
|
31
34
|
"ai",
|
|
32
35
|
"agent",
|
|
33
36
|
"alaya",
|
|
34
|
-
"llm"
|
|
37
|
+
"llm",
|
|
38
|
+
"rag"
|
|
35
39
|
]
|
|
36
40
|
}
|