@contextstream/mcp-server 0.3.15 β 0.3.16
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 +265 -272
- package/package.json +1 -1
- package/dist/index.js +0 -8493
package/README.md
CHANGED
|
@@ -2,47 +2,95 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@contextstream/mcp-server)
|
|
4
4
|
[](https://github.com/contextstream/mcp-server)
|
|
5
|
+
[](https://modelcontextprotocol.io)
|
|
5
6
|
|
|
6
|
-
|
|
7
|
+
> **Persistent memory + semantic search + dependency/impact analysis for Cursor, Claude Code, Windsurf, VS Code, Codex CLI, and any MCP client.**
|
|
7
8
|
|
|
8
|
-
|
|
9
|
+
<div align="center">
|
|
9
10
|
|
|
10
|
-
|
|
11
|
+
## π§ Your AI Finally Remembers
|
|
11
12
|
|
|
12
|
-
**
|
|
13
|
+
**The universal memory layer for AI coding tools.**
|
|
14
|
+
|
|
15
|
+
One integration. Every AI editor. Persistent memory that never forgets.
|
|
16
|
+
|
|
17
|
+
[Get Started](https://contextstream.io) Β· [Documentation](https://contextstream.io/docs/mcp) Β· [npm Package](https://www.npmjs.com/package/@contextstream/mcp-server)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
> β **If this saves you time, please star the repo β it helps others find it!**
|
|
22
|
+
|
|
23
|
+
<div align="center">
|
|
24
|
+
|
|
25
|
+
<a href="https://contextstream.io">
|
|
26
|
+
<img src="https://customer-vtx4jsqwkbsjpv5b.cloudflarestream.com/f083cfa709a679bd72ef48aca6fe0af2/thumbnails/thumbnail.gif?time=2s&height=600" alt="ContextStream Demo - AI that remembers across sessions" width="600" />
|
|
27
|
+
</a>
|
|
28
|
+
|
|
29
|
+
<sub>Your AI remembers decisions, preferences, and context β across sessions and tools.</sub>
|
|
30
|
+
|
|
31
|
+
</div>
|
|
13
32
|
|
|
14
33
|
---
|
|
15
34
|
|
|
16
|
-
##
|
|
35
|
+
## The Real Cost of AI Amnesia
|
|
36
|
+
|
|
37
|
+
Every developer using AI tools has felt this frustration:
|
|
38
|
+
|
|
39
|
+
**Monday morning.** You've spent 3 hours with Claude explaining your authentication architecture, the edge cases, why you chose JWT over sessions, the rate limiting strategy. The AI finally *gets it*. You ship great code together.
|
|
40
|
+
|
|
41
|
+
**Monday afternoon.** New chat window. The AI has no idea what JWT is in your context. It suggests sessions. You explain everything again.
|
|
17
42
|
|
|
18
|
-
|
|
19
|
-
- Close a chat with Cursor β Open a new one β AI forgot everything
|
|
20
|
-
- Switch from Claude to Windsurf β Start explaining from scratch
|
|
21
|
-
- New team member joins β Days of onboarding conversations
|
|
22
|
-
- "Why did we build it this way?" β No one remembers
|
|
43
|
+
**Tuesday.** You switch to Cursor for a quick refactor. Start from zero. "We use TypeScript with strict mode." "Our API follows REST conventions." "The user service is in `/src/services`." Again.
|
|
23
44
|
|
|
24
|
-
|
|
25
|
-
|
|
45
|
+
**A week later.** "Why did we build it this way?" Nobody remembers. The decision rationale is buried in a closed Slack thread. The AI certainly doesn't know.
|
|
46
|
+
|
|
47
|
+
**A month later.** New team member joins. Days of onboarding conversations. Explaining the same architectural decisions. Documenting tribal knowledge that should already exist.
|
|
48
|
+
|
|
49
|
+
**This isn't a minor inconvenience. It's death by a thousand cuts.**
|
|
50
|
+
|
|
51
|
+
Every re-explanation is lost productivity. Every forgotten decision is technical debt. Every context switch is cognitive load. Every new teammate is weeks of redundant knowledge transfer.
|
|
52
|
+
|
|
53
|
+
Your AI is brilliant for 30 minutes at a timeβthen it's a goldfish.
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## What If Your AI Actually Learned?
|
|
58
|
+
|
|
59
|
+
**ContextStream gives your AI a permanent brain.**
|
|
26
60
|
|
|
27
61
|
```
|
|
28
|
-
You: "Initialize session
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
62
|
+
You: "Initialize session. Remember: we use PostgreSQL, TypeScript strict mode,
|
|
63
|
+
and JWT for auth. Rate limits are 100 req/min per user."
|
|
64
|
+
|
|
65
|
+
...3 weeks later, different tool, new conversation...
|
|
66
|
+
|
|
67
|
+
You: "What database do we use?"
|
|
68
|
+
AI: "You're using PostgreSQL. You also prefer TypeScript with strict mode
|
|
69
|
+
and JWT authentication with 100 req/min rate limiting per user."
|
|
32
70
|
```
|
|
33
71
|
|
|
34
|
-
|
|
72
|
+
It remembers. **Across sessions. Across tools. Forever.**
|
|
73
|
+
|
|
74
|
+
Not just factsβ**decisions, context, and reasoning**:
|
|
75
|
+
|
|
76
|
+
```
|
|
77
|
+
You: "Why did we choose PostgreSQL over MongoDB?"
|
|
78
|
+
AI: "Based on your captured decision from March 15th: 'Chose PostgreSQL for
|
|
79
|
+
ACID compliance and complex joins in the reporting module. MongoDB
|
|
80
|
+
considered but rejected due to transaction requirements.'"
|
|
81
|
+
```
|
|
35
82
|
|
|
36
83
|
---
|
|
37
84
|
|
|
38
85
|
## π 2-Minute Setup
|
|
39
86
|
|
|
40
|
-
### 1. Get
|
|
41
|
-
Sign up at [contextstream.io](https://contextstream.io) β Settings β API Keys β Create
|
|
87
|
+
### 1. Get Your API Key
|
|
88
|
+
Sign up at [contextstream.io](https://contextstream.io) β Settings β API Keys β Create
|
|
42
89
|
|
|
43
|
-
### 2. Add to
|
|
90
|
+
### 2. Add to Your MCP Config
|
|
91
|
+
|
|
92
|
+
**Claude Code / Cursor / Windsurf / VS Code:**
|
|
44
93
|
|
|
45
|
-
**Cursor / Claude Code / Windsurf / VS Code:**
|
|
46
94
|
```json
|
|
47
95
|
{
|
|
48
96
|
"mcpServers": {
|
|
@@ -58,347 +106,292 @@ Sign up at [contextstream.io](https://contextstream.io) β Settings β API Key
|
|
|
58
106
|
}
|
|
59
107
|
```
|
|
60
108
|
|
|
61
|
-
**Codex CLI
|
|
109
|
+
**Codex CLI** (`~/.codex/config.toml`):
|
|
62
110
|
```toml
|
|
63
|
-
[
|
|
111
|
+
[mcp_servers.contextstream]
|
|
64
112
|
command = "npx"
|
|
65
113
|
args = ["-y", "@contextstream/mcp-server"]
|
|
66
114
|
|
|
67
|
-
[
|
|
115
|
+
[mcp_servers.contextstream.env]
|
|
68
116
|
CONTEXTSTREAM_API_URL = "https://api.contextstream.io"
|
|
69
117
|
CONTEXTSTREAM_API_KEY = "your_api_key"
|
|
70
118
|
```
|
|
71
119
|
|
|
72
|
-
|
|
73
|
-
Start a chat and say:
|
|
74
|
-
> "Initialize session and remember that I prefer TypeScript with strict mode"
|
|
120
|
+
> Codex expects snake_case `mcp_servers` keys. After editing, fully restart Codex.
|
|
75
121
|
|
|
76
|
-
|
|
77
|
-
> "What are my preferences?"
|
|
122
|
+
### AI Rules Files (Recommended)
|
|
78
123
|
|
|
79
|
-
|
|
124
|
+
Adding rules files ensures your AI automatically uses ContextStream for memory on every conversation.
|
|
80
125
|
|
|
81
|
-
|
|
126
|
+
> β οΈ **Critical: Tool Naming Convention**
|
|
127
|
+
>
|
|
128
|
+
> | AI Tool | Tool Name Format | Example |
|
|
129
|
+
> |---------|-----------------|---------|
|
|
130
|
+
> | **Claude Code** | `mcp__<server>__<tool>` | `mcp__contextstream__session_init` |
|
|
131
|
+
> | **All Others** (Codex, Cursor, Windsurf, Cline, etc.) | `<tool>` (raw) | `session_init` |
|
|
82
132
|
|
|
83
|
-
|
|
133
|
+
**For Claude Code** β Create `CLAUDE.md` in your project root:
|
|
134
|
+
```markdown
|
|
135
|
+
## ContextStream Integration
|
|
84
136
|
|
|
85
|
-
|
|
137
|
+
| Message | What to Call |
|
|
138
|
+
|---------|--------------|
|
|
139
|
+
| **1st message** | `mcp__contextstream__session_init(folder_path="...", context_hint="<user's message>")` |
|
|
140
|
+
| **2nd+ messages** | `mcp__contextstream__context_smart(user_message="<user's message>")` |
|
|
141
|
+
| **After tasks** | `mcp__contextstream__session_capture(...)` |
|
|
86
142
|
|
|
87
|
-
|
|
143
|
+
**NO EXCEPTIONS.** Call these tools before responding.
|
|
88
144
|
```
|
|
89
|
-
|
|
145
|
+
|
|
146
|
+
**For Codex CLI** β Create `AGENTS.md` in `~/.codex/` (global) or project root:
|
|
147
|
+
```markdown
|
|
148
|
+
## ContextStream Integration
|
|
149
|
+
|
|
150
|
+
| Message | What to Call |
|
|
151
|
+
|---------|--------------|
|
|
152
|
+
| **1st message** | `session_init(folder_path="...", context_hint="<user's message>")` |
|
|
153
|
+
| **2nd+ messages** | `context_smart(user_message="<user's message>")` |
|
|
154
|
+
| **After tasks** | `session_capture(...)` |
|
|
155
|
+
|
|
156
|
+
**NO EXCEPTIONS.** Call these tools before responding.
|
|
90
157
|
```
|
|
91
|
-
See all dependencies and side effects before refactoring.
|
|
92
158
|
|
|
93
|
-
|
|
159
|
+
**For other editors** β See [full templates in the docs](https://contextstream.io/docs/mcp).
|
|
160
|
+
|
|
161
|
+
### 3. Experience Memory
|
|
162
|
+
|
|
94
163
|
```
|
|
95
|
-
"
|
|
164
|
+
You: "Initialize session and remember I prefer functional React components"
|
|
96
165
|
```
|
|
97
|
-
Recall past decisions with full context and reasoning.
|
|
98
166
|
|
|
99
|
-
|
|
167
|
+
Open a **new conversation** (even in a different tool):
|
|
168
|
+
|
|
100
169
|
```
|
|
101
|
-
"
|
|
170
|
+
You: "What's my React preference?"
|
|
171
|
+
AI: "You prefer functional React components."
|
|
102
172
|
```
|
|
103
|
-
Search by meaning, not just keywords. Find code by intent.
|
|
104
173
|
|
|
105
|
-
|
|
174
|
+
β¨ **That's it. Your AI remembers now.**
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## Beyond Memory: Intelligence That Compounds
|
|
179
|
+
|
|
180
|
+
Memory is just the foundation. ContextStream understands your codebase at a deeper level.
|
|
181
|
+
|
|
182
|
+
### π΄ Lessons Learned β Never Repeat Mistakes
|
|
183
|
+
|
|
184
|
+
When your AI makes a mistakeβwrong approach, broken build, production issueβcapture it as a lesson:
|
|
185
|
+
|
|
106
186
|
```
|
|
107
|
-
"
|
|
187
|
+
You: "Capture lesson: Always run tests before pushing to main"
|
|
108
188
|
```
|
|
109
|
-
Visualize connections between code, decisions, and docs.
|
|
110
189
|
|
|
111
|
-
|
|
190
|
+
**These lessons surface automatically in future sessions.** Before the AI takes a similar action, it sees the warning. Your AI learns from mistakes just like you do.
|
|
112
191
|
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
|
117
|
-
|
|
118
|
-
| `search_semantic` | Find code by meaning, not just keywords |
|
|
119
|
-
| `search_hybrid` | Combines semantic + keyword for best results |
|
|
120
|
-
| `search_pattern` | Regex-based code search |
|
|
121
|
-
| `ai_context` | Automatically gather relevant code, docs, and memory |
|
|
122
|
-
|
|
123
|
-
### π§ Memory & Knowledge
|
|
124
|
-
| Tool | Description |
|
|
125
|
-
|------|-------------|
|
|
126
|
-
| `session_remember` | Quick natural language memory ("Remember I prefer TypeScript") |
|
|
127
|
-
| `session_recall` | Quick recall ("What were the auth decisions?") |
|
|
128
|
-
| `memory_create_event` | Store decisions, insights, and context |
|
|
129
|
-
| `memory_search` | Find relevant past context |
|
|
130
|
-
| `memory_decisions` | Get decision summaries |
|
|
131
|
-
|
|
132
|
-
### π Code Intelligence
|
|
133
|
-
| Tool | Description |
|
|
134
|
-
|------|-------------|
|
|
135
|
-
| `graph_dependencies` | Understand what depends on what |
|
|
136
|
-
| `graph_call_path` | Trace execution flows |
|
|
137
|
-
| `graph_impact` | Understand change impact |
|
|
138
|
-
| `graph_circular_dependencies` | Find problematic cycles |
|
|
139
|
-
| `graph_unused_code` | Identify dead code |
|
|
140
|
-
|
|
141
|
-
### π€ AI Integration
|
|
142
|
-
| Tool | Description |
|
|
143
|
-
|------|-------------|
|
|
144
|
-
| `ai_context` | Build LLM-ready context from your codebase |
|
|
145
|
-
| `ai_enhanced_context` | Deep analysis with memory integration |
|
|
146
|
-
| `ai_plan` | AI-powered development planning |
|
|
147
|
-
| `ai_tasks` | Break down work into actionable tasks |
|
|
148
|
-
|
|
149
|
-
### π Session Management
|
|
150
|
-
| Tool | Description |
|
|
151
|
-
|------|-------------|
|
|
152
|
-
| `session_init` | Initialize conversation with auto-context |
|
|
153
|
-
| `context_smart` | Get relevant context for any message |
|
|
154
|
-
| `session_capture` | Store context to memory |
|
|
155
|
-
| `session_compress` | Compress chat history to memory |
|
|
192
|
+
| Trigger | Example |
|
|
193
|
+
|---------|---------|
|
|
194
|
+
| User correction | "No, we use PostgreSQL not MySQL" |
|
|
195
|
+
| Production issue | "That deploy broke the API" |
|
|
196
|
+
| Workflow mistake | "You forgot to run the linter" |
|
|
156
197
|
|
|
157
|
-
|
|
198
|
+
Lessons are categorized by severity (`critical`, `high`, `medium`, `low`) and automatically retrieved when relevant context is detected.
|
|
158
199
|
|
|
159
|
-
|
|
200
|
+
### π Impact Analysis
|
|
201
|
+
|
|
202
|
+
```
|
|
203
|
+
You: "What breaks if I change the UserService class?"
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
See all dependencies and side effects **before** you refactor. No more surprise breakages.
|
|
207
|
+
|
|
208
|
+
### π Semantic Code Search
|
|
209
|
+
|
|
210
|
+
```
|
|
211
|
+
You: "Find where we handle authentication errors"
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
Search by **meaning**, not keywords. Find code by what it does, not what it's named.
|
|
215
|
+
|
|
216
|
+
### 𧬠Knowledge Graph
|
|
160
217
|
|
|
161
|
-
|
|
218
|
+
Decisions, code, and documentationβall connected. Ask "why" and get answers with full context.
|
|
162
219
|
|
|
163
|
-
|
|
220
|
+
### π€ Auto-Context Loading
|
|
221
|
+
|
|
222
|
+
Context loads **automatically** on first interaction. No manual setup:
|
|
164
223
|
|
|
165
224
|
```
|
|
166
225
|
βββββββββββββββββββββββββββββββββββββββββββ
|
|
167
226
|
π§ AUTO-CONTEXT LOADED (ContextStream)
|
|
168
227
|
βββββββββββββββββββββββββββββββββββββββββββ
|
|
169
|
-
π Workspace:
|
|
228
|
+
π Workspace: acme-corp
|
|
170
229
|
π Project: backend-api
|
|
171
230
|
|
|
172
231
|
π Recent Decisions:
|
|
173
232
|
β’ Use PostgreSQL for persistence
|
|
174
233
|
β’ JWT for authentication
|
|
175
234
|
|
|
235
|
+
β οΈ Active Lessons:
|
|
236
|
+
β’ Always run tests before pushing
|
|
237
|
+
|
|
176
238
|
π§ Recent Context:
|
|
177
|
-
β’ [decision] API
|
|
239
|
+
β’ [decision] API rate limiting strategy
|
|
178
240
|
β’ [preference] TypeScript strict mode
|
|
179
241
|
βββββββββββββββββββββββββββββββββββββββββββ
|
|
180
242
|
```
|
|
181
243
|
|
|
182
|
-
Works with **all MCP clients** β no client-side changes required.
|
|
183
|
-
|
|
184
244
|
---
|
|
185
245
|
|
|
186
|
-
##
|
|
246
|
+
## 71 MCP Tools
|
|
187
247
|
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
248
|
+
### Session & Memory
|
|
249
|
+
| Tool | What It Does |
|
|
250
|
+
|------|--------------|
|
|
251
|
+
| `session_init` | Initialize with auto-context loading |
|
|
252
|
+
| `context_smart` | Get relevant context for any message |
|
|
253
|
+
| `session_remember` | Natural language: "Remember X" |
|
|
254
|
+
| `session_recall` | Natural language: "What did we decide about X?" |
|
|
255
|
+
| `session_capture` | Store decisions, insights, preferences |
|
|
256
|
+
| `session_capture_lesson` | **Capture mistakes to prevent repeating them** |
|
|
257
|
+
| `session_get_lessons` | Retrieve relevant lessons |
|
|
258
|
+
|
|
259
|
+
### Code Intelligence
|
|
260
|
+
| Tool | What It Does |
|
|
261
|
+
|------|--------------|
|
|
262
|
+
| `search_semantic` | Find code by meaning |
|
|
263
|
+
| `search_hybrid` | Semantic + keyword combined |
|
|
264
|
+
| `graph_dependencies` | See what depends on what |
|
|
265
|
+
| `graph_impact` | Understand change impact |
|
|
266
|
+
| `graph_call_path` | Trace execution flows |
|
|
267
|
+
| `graph_unused_code` | Find dead code |
|
|
194
268
|
|
|
195
|
-
|
|
269
|
+
### AI Integration
|
|
270
|
+
| Tool | What It Does |
|
|
271
|
+
|------|--------------|
|
|
272
|
+
| `ai_context` | Build LLM-ready context |
|
|
273
|
+
| `ai_context_budget` | Context within token limits |
|
|
274
|
+
| `ai_plan` | Generate development plans |
|
|
275
|
+
| `ai_tasks` | Break work into tasks |
|
|
196
276
|
|
|
197
|
-
|
|
198
|
-
|-----------------|---------------|
|
|
199
|
-
| β Vendor lock-in β switch tools, lose everything | β **Universal** β Cursor, Claude, Windsurf, any MCP tool |
|
|
200
|
-
| β Expires or resets over time | β **Persistent forever** β never lose context (paid plans) |
|
|
201
|
-
| β No semantic search | β **Semantic search** β find anything across all history |
|
|
202
|
-
| β Personal only β teammates start from zero | β **Team memory** β shared context, instant onboarding |
|
|
203
|
-
| β No API access | β **60+ MCP tools** β full API and automation |
|
|
204
|
-
| β Memory isolated from code | β **Knowledge graph** β decisions linked to code |
|
|
205
|
-
| β Clunky to use | β **Natural language** β "remember X", "what did we decide about Y?" |
|
|
277
|
+
[**View all 71 tools β**](https://contextstream.io/docs/mcp)
|
|
206
278
|
|
|
207
279
|
---
|
|
208
280
|
|
|
209
|
-
##
|
|
210
|
-
|
|
211
|
-
<details>
|
|
212
|
-
<summary><strong>Authentication</strong></summary>
|
|
213
|
-
|
|
214
|
-
| Tool | Description |
|
|
215
|
-
|------|-------------|
|
|
216
|
-
| `auth_me` | Get current user profile |
|
|
217
|
-
|
|
218
|
-
</details>
|
|
219
|
-
|
|
220
|
-
<details>
|
|
221
|
-
<summary><strong>Workspaces</strong></summary>
|
|
222
|
-
|
|
223
|
-
| Tool | Description |
|
|
224
|
-
|------|-------------|
|
|
225
|
-
| `workspaces_list` | List accessible workspaces |
|
|
226
|
-
| `workspaces_get` | Get workspace details |
|
|
227
|
-
| `workspaces_create` | Create a new workspace |
|
|
228
|
-
| `workspaces_overview` | Get workspace summary |
|
|
229
|
-
| `workspaces_analytics` | Get usage analytics |
|
|
230
|
-
| `workspaces_content` | List workspace content |
|
|
231
|
-
|
|
232
|
-
</details>
|
|
233
|
-
|
|
234
|
-
<details>
|
|
235
|
-
<summary><strong>Projects</strong></summary>
|
|
236
|
-
|
|
237
|
-
| Tool | Description |
|
|
238
|
-
|------|-------------|
|
|
239
|
-
| `projects_list` | List projects (by workspace) |
|
|
240
|
-
| `projects_get` | Get project details |
|
|
241
|
-
| `projects_create` | Create a new project |
|
|
242
|
-
| `projects_overview` | Get project summary |
|
|
243
|
-
| `projects_statistics` | Get code statistics |
|
|
244
|
-
| `projects_files` | List indexed files |
|
|
245
|
-
| `projects_index` | Trigger re-indexing |
|
|
246
|
-
| `projects_index_status` | Check indexing status |
|
|
247
|
-
|
|
248
|
-
</details>
|
|
249
|
-
|
|
250
|
-
<details>
|
|
251
|
-
<summary><strong>Search</strong></summary>
|
|
252
|
-
|
|
253
|
-
| Tool | Description |
|
|
254
|
-
|------|-------------|
|
|
255
|
-
| `search_semantic` | Semantic vector search |
|
|
256
|
-
| `search_hybrid` | Combined semantic + keyword |
|
|
257
|
-
| `search_keyword` | Traditional keyword search |
|
|
258
|
-
| `search_pattern` | Regex pattern search |
|
|
259
|
-
| `search_suggestions` | Get search suggestions |
|
|
260
|
-
|
|
261
|
-
</details>
|
|
262
|
-
|
|
263
|
-
<details>
|
|
264
|
-
<summary><strong>Memory</strong></summary>
|
|
265
|
-
|
|
266
|
-
| Tool | Description |
|
|
267
|
-
|------|-------------|
|
|
268
|
-
| `memory_create_event` | Store a memory event |
|
|
269
|
-
| `memory_get_event` | Retrieve an event |
|
|
270
|
-
| `memory_update_event` | Update an event |
|
|
271
|
-
| `memory_delete_event` | Remove an event |
|
|
272
|
-
| `memory_list_events` | List events in workspace |
|
|
273
|
-
| `memory_bulk_ingest` | Bulk import events |
|
|
274
|
-
| `memory_distill_event` | Extract key insights |
|
|
275
|
-
| `memory_create_node` | Create knowledge node |
|
|
276
|
-
| `memory_get_node` | Get knowledge node |
|
|
277
|
-
| `memory_update_node` | Update knowledge node |
|
|
278
|
-
| `memory_delete_node` | Remove knowledge node |
|
|
279
|
-
| `memory_supersede_node` | Replace with new version |
|
|
280
|
-
| `memory_list_nodes` | List knowledge nodes |
|
|
281
|
-
| `memory_search` | Search memory |
|
|
282
|
-
| `memory_decisions` | Get decision summaries |
|
|
283
|
-
| `memory_timeline` | Get chronological timeline |
|
|
284
|
-
| `memory_summary` | Get condensed summary |
|
|
285
|
-
|
|
286
|
-
</details>
|
|
287
|
-
|
|
288
|
-
<details>
|
|
289
|
-
<summary><strong>Graph Analysis</strong></summary>
|
|
290
|
-
|
|
291
|
-
| Tool | Description |
|
|
292
|
-
|------|-------------|
|
|
293
|
-
| `graph_related` | Find related knowledge nodes |
|
|
294
|
-
| `graph_path` | Find path between nodes |
|
|
295
|
-
| `graph_decisions` | Decision history in graph |
|
|
296
|
-
| `graph_dependencies` | Query code dependencies |
|
|
297
|
-
| `graph_call_path` | Trace call paths |
|
|
298
|
-
| `graph_impact` | Analyze change impact |
|
|
299
|
-
| `graph_circular_dependencies` | Find circular deps |
|
|
300
|
-
| `graph_unused_code` | Find dead code |
|
|
301
|
-
| `graph_contradictions` | Find conflicting info |
|
|
302
|
-
|
|
303
|
-
</details>
|
|
281
|
+
## Why Not Built-in Memory?
|
|
304
282
|
|
|
305
|
-
|
|
306
|
-
|
|
283
|
+
| Built-in "Memory" | ContextStream |
|
|
284
|
+
|-------------------|---------------|
|
|
285
|
+
| π Locked to one vendor | π **Universal** β works with Cursor, Claude, Windsurf, any MCP client |
|
|
286
|
+
| β±οΈ Expires or resets | βΎοΈ **Persistent** β never lose context |
|
|
287
|
+
| π Basic key-value | π§ **Semantic** β understands meaning and relationships |
|
|
288
|
+
| π€ Personal only | π₯ **Team-ready** β shared workspace, instant onboarding |
|
|
289
|
+
| β No lessons | β
**Learns from mistakes** β captures and surfaces lessons |
|
|
290
|
+
| β No code understanding | π **Deep analysis** β dependencies, impact, knowledge graph |
|
|
291
|
+
| π€· Hope it remembers | π― **Deterministic** β you control what's stored |
|
|
307
292
|
|
|
308
|
-
|
|
309
|
-
|------|-------------|
|
|
310
|
-
| `ai_context` | Build LLM context |
|
|
311
|
-
| `ai_enhanced_context` | Deep context with memory |
|
|
312
|
-
| `ai_embeddings` | Generate embeddings |
|
|
313
|
-
| `ai_plan` | Generate dev plan |
|
|
314
|
-
| `ai_tasks` | Generate tasks |
|
|
293
|
+
---
|
|
315
294
|
|
|
316
|
-
|
|
295
|
+
## Privacy & Security
|
|
317
296
|
|
|
318
|
-
|
|
319
|
-
|
|
297
|
+
- **π Encrypted at rest** β AES-256 encryption for all stored data
|
|
298
|
+
- **π« Never trains on your data** β Your code is yours. Period.
|
|
299
|
+
- **ποΈ You control access** β Workspace permissions, API key management
|
|
300
|
+
- **ποΈ Delete anytime** β Full data deletion on request
|
|
320
301
|
|
|
321
|
-
|
|
322
|
-
|------|-------------|
|
|
323
|
-
| `session_init` | Initialize conversation |
|
|
324
|
-
| `session_get_user_context` | Get user preferences |
|
|
325
|
-
| `session_capture` | Store context to memory |
|
|
326
|
-
| `session_smart_search` | Search with context enrichment |
|
|
327
|
-
| `session_remember` | Quick natural language memory |
|
|
328
|
-
| `session_recall` | Quick natural language recall |
|
|
329
|
-
| `context_smart` | Get relevant context for message |
|
|
330
|
-
| `session_compress` | Compress chat history to memory |
|
|
331
|
-
| `session_summary` | Get compact workspace summary |
|
|
332
|
-
| `session_delta` | Get changes since timestamp |
|
|
302
|
+
---
|
|
333
303
|
|
|
334
|
-
|
|
304
|
+
## Works Everywhere
|
|
335
305
|
|
|
336
|
-
|
|
306
|
+
ContextStream uses the [Model Context Protocol](https://modelcontextprotocol.io)βthe emerging standard for AI tool integrations.
|
|
337
307
|
|
|
338
|
-
|
|
308
|
+
**Supported today:**
|
|
309
|
+
- Claude Code
|
|
310
|
+
- Cursor
|
|
311
|
+
- Windsurf
|
|
312
|
+
- VS Code (with MCP extension)
|
|
313
|
+
- Codex CLI
|
|
314
|
+
- Cline
|
|
315
|
+
- Kilo Code
|
|
316
|
+
- Roo Code
|
|
317
|
+
- Any MCP-compatible client
|
|
339
318
|
|
|
340
|
-
|
|
341
|
-
|--------|-------------|
|
|
342
|
-
| `explore-codebase` | Get a codebase overview |
|
|
343
|
-
| `capture-decision` | Document an ADR |
|
|
344
|
-
| `review-context` | Build code review context |
|
|
345
|
-
| `investigate-bug` | Debug investigation helper |
|
|
346
|
-
| `explore-knowledge` | Navigate knowledge graph |
|
|
347
|
-
| `onboard-to-project` | Generate onboarding guide |
|
|
348
|
-
| `analyze-refactoring` | Find refactoring opportunities |
|
|
349
|
-
| `build-context` | Build comprehensive LLM context |
|
|
319
|
+
**One integration. Every tool. Same memory.**
|
|
350
320
|
|
|
351
321
|
---
|
|
352
322
|
|
|
353
|
-
##
|
|
323
|
+
## Quick Reference
|
|
324
|
+
|
|
325
|
+
### Environment Variables
|
|
354
326
|
|
|
355
327
|
| Variable | Required | Description |
|
|
356
328
|
|----------|----------|-------------|
|
|
357
|
-
| `CONTEXTSTREAM_API_URL` | Yes |
|
|
358
|
-
| `CONTEXTSTREAM_API_KEY` | Yes | Your API key
|
|
329
|
+
| `CONTEXTSTREAM_API_URL` | Yes | `https://api.contextstream.io` |
|
|
330
|
+
| `CONTEXTSTREAM_API_KEY` | Yes | Your API key |
|
|
331
|
+
|
|
332
|
+
### Essential Commands
|
|
333
|
+
|
|
334
|
+
```bash
|
|
335
|
+
# Install globally
|
|
336
|
+
npm install -g @contextstream/mcp-server
|
|
337
|
+
|
|
338
|
+
# Or run via npx (recommended for MCP configs)
|
|
339
|
+
npx @contextstream/mcp-server
|
|
340
|
+
```
|
|
341
|
+
|
|
342
|
+
### First Session Checklist
|
|
343
|
+
|
|
344
|
+
1. β
Add MCP config to your editor
|
|
345
|
+
2. β
Start a conversation: "Initialize session for [project-name]"
|
|
346
|
+
3. β
Tell it your preferences: "Remember we use TypeScript strict mode"
|
|
347
|
+
4. β
Make a decision: "Capture decision: Using PostgreSQL for the user database"
|
|
348
|
+
5. β
Open a new conversation and ask: "What are my preferences?"
|
|
359
349
|
|
|
360
350
|
---
|
|
361
351
|
|
|
362
|
-
##
|
|
352
|
+
## Links
|
|
363
353
|
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
354
|
+
| Resource | URL |
|
|
355
|
+
|----------|-----|
|
|
356
|
+
| Website | [contextstream.io](https://contextstream.io) |
|
|
357
|
+
| Documentation | [contextstream.io/docs](https://contextstream.io/docs) |
|
|
358
|
+
| MCP Setup Guide | [contextstream.io/docs/mcp](https://contextstream.io/docs/mcp) |
|
|
359
|
+
| npm Package | [@contextstream/mcp-server](https://www.npmjs.com/package/@contextstream/mcp-server) |
|
|
360
|
+
| GitHub | [contextstream/mcp-server](https://github.com/contextstream/mcp-server) |
|
|
369
361
|
|
|
370
362
|
---
|
|
371
363
|
|
|
372
|
-
##
|
|
364
|
+
## Contributing
|
|
373
365
|
|
|
374
|
-
We welcome contributions
|
|
366
|
+
We welcome contributions:
|
|
375
367
|
|
|
376
|
-
1. **Report bugs** β Open an issue
|
|
377
|
-
2. **Request features** β Share
|
|
378
|
-
3. **Submit PRs** β Fork
|
|
368
|
+
1. **Report bugs** β [Open an issue](https://github.com/contextstream/mcp-server/issues)
|
|
369
|
+
2. **Request features** β Share ideas in GitHub Issues
|
|
370
|
+
3. **Submit PRs** β Fork, branch, and submit
|
|
379
371
|
|
|
380
372
|
### Development
|
|
381
373
|
|
|
382
374
|
```bash
|
|
383
|
-
# Clone the repo
|
|
384
375
|
git clone https://github.com/contextstream/mcp-server.git
|
|
385
376
|
cd mcp-server
|
|
386
|
-
|
|
387
|
-
# Install dependencies
|
|
388
377
|
npm install
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
npm run dev
|
|
392
|
-
|
|
393
|
-
# Build for production
|
|
394
|
-
npm run build
|
|
395
|
-
|
|
396
|
-
# Type check
|
|
378
|
+
npm run dev # Development mode
|
|
379
|
+
npm run build # Production build
|
|
397
380
|
npm run typecheck
|
|
398
381
|
```
|
|
399
382
|
|
|
400
383
|
---
|
|
401
384
|
|
|
402
|
-
##
|
|
385
|
+
## License
|
|
403
386
|
|
|
404
387
|
MIT
|
|
388
|
+
|
|
389
|
+
---
|
|
390
|
+
|
|
391
|
+
<div align="center">
|
|
392
|
+
|
|
393
|
+
**Stop re-explaining. Start building.**
|
|
394
|
+
|
|
395
|
+
[Get Started β](https://contextstream.io)
|
|
396
|
+
|
|
397
|
+
</div>
|
package/package.json
CHANGED