@contextstream/mcp-server 0.3.11 → 0.3.13
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 +206 -87
- package/package.json +5 -1
package/README.md
CHANGED
|
@@ -2,41 +2,46 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@contextstream/mcp-server)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## 🧠 Your AI's Permanent Brain — Across Every Tool, Every Conversation
|
|
6
|
+
|
|
7
|
+
**Tired of re-explaining your codebase to AI every single time?**
|
|
8
|
+
|
|
9
|
+
ContextStream gives your AI persistent memory that follows you everywhere. Decisions remembered. Context preserved. No more repeating yourself.
|
|
6
10
|
|
|
7
11
|
**Website:** [contextstream.io](https://contextstream.io) | **Docs:** [contextstream.io/docs/mcp](https://contextstream.io/docs/mcp)
|
|
8
12
|
|
|
9
|
-
|
|
13
|
+
---
|
|
10
14
|
|
|
11
|
-
|
|
12
|
-
- **Semantic search** — Find code by meaning, not just keywords
|
|
13
|
-
- **Hybrid search** — Combines semantic + keyword for best results
|
|
14
|
-
- **Pattern search** — Regex-based code search
|
|
15
|
-
- **AI context building** — Automatically gather relevant code, docs, and memory
|
|
15
|
+
## ✨ Why ContextStream?
|
|
16
16
|
|
|
17
|
-
###
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
17
|
+
### The Problem
|
|
18
|
+
- Close a chat with Cursor → Open a new one → AI forgot everything
|
|
19
|
+
- Switch from Claude to Windsurf → Start explaining from scratch
|
|
20
|
+
- New team member joins → Days of onboarding conversations
|
|
21
|
+
- "Why did we build it this way?" → No one remembers
|
|
22
22
|
|
|
23
|
-
###
|
|
24
|
-
|
|
25
|
-
- **Call path tracing** — Trace execution flows
|
|
26
|
-
- **Impact analysis** — Understand change impact
|
|
27
|
-
- **Circular dependency detection** — Find problematic cycles
|
|
28
|
-
- **Unused code detection** — Identify dead code
|
|
23
|
+
### The Solution
|
|
24
|
+
ContextStream is a **universal memory layer** for AI coding tools. It works with **Cursor, Claude Code, Windsurf, VS Code**, and any MCP-compatible client.
|
|
29
25
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
26
|
+
```
|
|
27
|
+
You: "Initialize session and remember we use PostgreSQL with TypeScript strict mode"
|
|
28
|
+
...later, in a NEW conversation...
|
|
29
|
+
You: "What are my preferences for this project?"
|
|
30
|
+
AI: "You prefer TypeScript with strict mode, and you're using PostgreSQL."
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
**It remembers. Across sessions. Across tools. Forever.**
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## 🚀 2-Minute Setup
|
|
35
38
|
|
|
36
|
-
|
|
39
|
+
### 1. Get your API key (30 seconds)
|
|
40
|
+
Sign up at [contextstream.io](https://contextstream.io) → Settings → API Keys → Create one.
|
|
37
41
|
|
|
38
|
-
Add
|
|
42
|
+
### 2. Add to your MCP config (60 seconds)
|
|
39
43
|
|
|
44
|
+
**Cursor / Claude Code / Windsurf / VS Code:**
|
|
40
45
|
```json
|
|
41
46
|
{
|
|
42
47
|
"mcpServers": {
|
|
@@ -52,12 +57,7 @@ Add ContextStream to your AI tool's MCP configuration (works with **Cursor**, **
|
|
|
52
57
|
}
|
|
53
58
|
```
|
|
54
59
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
### Codex (CLI) configuration
|
|
58
|
-
|
|
59
|
-
For the Codex CLI, add the MCP server to your `~/.codex/config.toml`:
|
|
60
|
-
|
|
60
|
+
**Codex CLI:** Add to `~/.codex/config.toml`:
|
|
61
61
|
```toml
|
|
62
62
|
[mcpServers.contextstream]
|
|
63
63
|
command = "npx"
|
|
@@ -68,11 +68,98 @@ CONTEXTSTREAM_API_URL = "https://api.contextstream.io"
|
|
|
68
68
|
CONTEXTSTREAM_API_KEY = "your_api_key"
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
|
|
71
|
+
### 3. Try it out (30 seconds)
|
|
72
|
+
Start a chat and say:
|
|
73
|
+
> "Initialize session and remember that I prefer TypeScript with strict mode"
|
|
74
|
+
|
|
75
|
+
Then start a **brand new conversation** and ask:
|
|
76
|
+
> "What are my preferences?"
|
|
77
|
+
|
|
78
|
+
✨ **It remembers.**
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## 🔥 Beyond Memory — That's Just the Beginning
|
|
83
|
+
|
|
84
|
+
ContextStream isn't just memory storage. It understands your code.
|
|
85
|
+
|
|
86
|
+
### Impact Analysis
|
|
87
|
+
```
|
|
88
|
+
"What breaks if I change the UserService class?"
|
|
89
|
+
```
|
|
90
|
+
See all dependencies and side effects before refactoring.
|
|
91
|
+
|
|
92
|
+
### Decision History
|
|
93
|
+
```
|
|
94
|
+
"Why did we choose PostgreSQL over MongoDB?"
|
|
95
|
+
```
|
|
96
|
+
Recall past decisions with full context and reasoning.
|
|
97
|
+
|
|
98
|
+
### Semantic Code Search
|
|
99
|
+
```
|
|
100
|
+
"Find where we handle rate limiting"
|
|
101
|
+
```
|
|
102
|
+
Search by meaning, not just keywords. Find code by intent.
|
|
103
|
+
|
|
104
|
+
### Knowledge Graph
|
|
105
|
+
```
|
|
106
|
+
"Show dependencies for the auth module"
|
|
107
|
+
```
|
|
108
|
+
Visualize connections between code, decisions, and docs.
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## 📊 60+ MCP Tools at Your Fingertips
|
|
113
|
+
|
|
114
|
+
### 🔍 Code Search & Context
|
|
115
|
+
| Tool | Description |
|
|
116
|
+
|------|-------------|
|
|
117
|
+
| `search_semantic` | Find code by meaning, not just keywords |
|
|
118
|
+
| `search_hybrid` | Combines semantic + keyword for best results |
|
|
119
|
+
| `search_pattern` | Regex-based code search |
|
|
120
|
+
| `ai_context` | Automatically gather relevant code, docs, and memory |
|
|
121
|
+
|
|
122
|
+
### 🧠 Memory & Knowledge
|
|
123
|
+
| Tool | Description |
|
|
124
|
+
|------|-------------|
|
|
125
|
+
| `session_remember` | Quick natural language memory ("Remember I prefer TypeScript") |
|
|
126
|
+
| `session_recall` | Quick recall ("What were the auth decisions?") |
|
|
127
|
+
| `memory_create_event` | Store decisions, insights, and context |
|
|
128
|
+
| `memory_search` | Find relevant past context |
|
|
129
|
+
| `memory_decisions` | Get decision summaries |
|
|
130
|
+
|
|
131
|
+
### 📊 Code Intelligence
|
|
132
|
+
| Tool | Description |
|
|
133
|
+
|------|-------------|
|
|
134
|
+
| `graph_dependencies` | Understand what depends on what |
|
|
135
|
+
| `graph_call_path` | Trace execution flows |
|
|
136
|
+
| `graph_impact` | Understand change impact |
|
|
137
|
+
| `graph_circular_dependencies` | Find problematic cycles |
|
|
138
|
+
| `graph_unused_code` | Identify dead code |
|
|
139
|
+
|
|
140
|
+
### 🤖 AI Integration
|
|
141
|
+
| Tool | Description |
|
|
142
|
+
|------|-------------|
|
|
143
|
+
| `ai_context` | Build LLM-ready context from your codebase |
|
|
144
|
+
| `ai_enhanced_context` | Deep analysis with memory integration |
|
|
145
|
+
| `ai_plan` | AI-powered development planning |
|
|
146
|
+
| `ai_tasks` | Break down work into actionable tasks |
|
|
147
|
+
|
|
148
|
+
### 🚀 Session Management
|
|
149
|
+
| Tool | Description |
|
|
150
|
+
|------|-------------|
|
|
151
|
+
| `session_init` | Initialize conversation with auto-context |
|
|
152
|
+
| `context_smart` | Get relevant context for any message |
|
|
153
|
+
| `session_capture` | Store context to memory |
|
|
154
|
+
| `session_compress` | Compress chat history to memory |
|
|
155
|
+
|
|
156
|
+
[See all 60+ tools →](https://contextstream.io/docs/mcp)
|
|
157
|
+
|
|
158
|
+
---
|
|
72
159
|
|
|
73
160
|
## ✨ Auto-Context (v0.3.0+)
|
|
74
161
|
|
|
75
|
-
Context loads **automatically** on the first tool call
|
|
162
|
+
Context loads **automatically** on the first tool call. No manual setup required.
|
|
76
163
|
|
|
77
164
|
```
|
|
78
165
|
═══════════════════════════════════════════
|
|
@@ -93,21 +180,45 @@ Context loads **automatically** on the first tool call of any conversation. No n
|
|
|
93
180
|
|
|
94
181
|
Works with **all MCP clients** — no client-side changes required.
|
|
95
182
|
|
|
96
|
-
|
|
183
|
+
---
|
|
97
184
|
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
185
|
+
## 🛡️ Privacy & Security
|
|
186
|
+
|
|
187
|
+
- **Encrypted at rest** — All data encrypted with AES-256
|
|
188
|
+
- **No training on your data** — We never use your code to train AI
|
|
189
|
+
- **You control access** — Workspace permissions & API keys
|
|
190
|
+
- **Self-host option** — Enterprise can self-host for full control
|
|
191
|
+
|
|
192
|
+
---
|
|
102
193
|
|
|
103
|
-
##
|
|
194
|
+
## 🏆 Why Not Built-in Memory?
|
|
195
|
+
|
|
196
|
+
| Built-in memory | ContextStream |
|
|
197
|
+
|-----------------|---------------|
|
|
198
|
+
| ✗ Vendor lock-in — switch tools, lose everything | ✓ **Universal** — Cursor, Claude, Windsurf, any MCP tool |
|
|
199
|
+
| ✗ Expires or resets over time | ✓ **Persistent forever** — never lose context (paid plans) |
|
|
200
|
+
| ✗ No semantic search | ✓ **Semantic search** — find anything across all history |
|
|
201
|
+
| ✗ Personal only — teammates start from zero | ✓ **Team memory** — shared context, instant onboarding |
|
|
202
|
+
| ✗ No API access | ✓ **60+ MCP tools** — full API and automation |
|
|
203
|
+
| ✗ Memory isolated from code | ✓ **Knowledge graph** — decisions linked to code |
|
|
204
|
+
| ✗ Clunky to use | ✓ **Natural language** — "remember X", "what did we decide about Y?" |
|
|
205
|
+
|
|
206
|
+
---
|
|
207
|
+
|
|
208
|
+
## 📖 Full Tool Reference
|
|
209
|
+
|
|
210
|
+
<details>
|
|
211
|
+
<summary><strong>Authentication</strong></summary>
|
|
104
212
|
|
|
105
|
-
### Authentication
|
|
106
213
|
| Tool | Description |
|
|
107
214
|
|------|-------------|
|
|
108
215
|
| `auth_me` | Get current user profile |
|
|
109
216
|
|
|
110
|
-
|
|
217
|
+
</details>
|
|
218
|
+
|
|
219
|
+
<details>
|
|
220
|
+
<summary><strong>Workspaces</strong></summary>
|
|
221
|
+
|
|
111
222
|
| Tool | Description |
|
|
112
223
|
|------|-------------|
|
|
113
224
|
| `workspaces_list` | List accessible workspaces |
|
|
@@ -117,7 +228,11 @@ Works with **all MCP clients** — no client-side changes required.
|
|
|
117
228
|
| `workspaces_analytics` | Get usage analytics |
|
|
118
229
|
| `workspaces_content` | List workspace content |
|
|
119
230
|
|
|
120
|
-
|
|
231
|
+
</details>
|
|
232
|
+
|
|
233
|
+
<details>
|
|
234
|
+
<summary><strong>Projects</strong></summary>
|
|
235
|
+
|
|
121
236
|
| Tool | Description |
|
|
122
237
|
|------|-------------|
|
|
123
238
|
| `projects_list` | List projects (by workspace) |
|
|
@@ -129,7 +244,11 @@ Works with **all MCP clients** — no client-side changes required.
|
|
|
129
244
|
| `projects_index` | Trigger re-indexing |
|
|
130
245
|
| `projects_index_status` | Check indexing status |
|
|
131
246
|
|
|
132
|
-
|
|
247
|
+
</details>
|
|
248
|
+
|
|
249
|
+
<details>
|
|
250
|
+
<summary><strong>Search</strong></summary>
|
|
251
|
+
|
|
133
252
|
| Tool | Description |
|
|
134
253
|
|------|-------------|
|
|
135
254
|
| `search_semantic` | Semantic vector search |
|
|
@@ -138,7 +257,11 @@ Works with **all MCP clients** — no client-side changes required.
|
|
|
138
257
|
| `search_pattern` | Regex pattern search |
|
|
139
258
|
| `search_suggestions` | Get search suggestions |
|
|
140
259
|
|
|
141
|
-
|
|
260
|
+
</details>
|
|
261
|
+
|
|
262
|
+
<details>
|
|
263
|
+
<summary><strong>Memory</strong></summary>
|
|
264
|
+
|
|
142
265
|
| Tool | Description |
|
|
143
266
|
|------|-------------|
|
|
144
267
|
| `memory_create_event` | Store a memory event |
|
|
@@ -159,7 +282,11 @@ Works with **all MCP clients** — no client-side changes required.
|
|
|
159
282
|
| `memory_timeline` | Get chronological timeline |
|
|
160
283
|
| `memory_summary` | Get condensed summary |
|
|
161
284
|
|
|
162
|
-
|
|
285
|
+
</details>
|
|
286
|
+
|
|
287
|
+
<details>
|
|
288
|
+
<summary><strong>Graph Analysis</strong></summary>
|
|
289
|
+
|
|
163
290
|
| Tool | Description |
|
|
164
291
|
|------|-------------|
|
|
165
292
|
| `graph_related` | Find related knowledge nodes |
|
|
@@ -172,7 +299,11 @@ Works with **all MCP clients** — no client-side changes required.
|
|
|
172
299
|
| `graph_unused_code` | Find dead code |
|
|
173
300
|
| `graph_contradictions` | Find conflicting info |
|
|
174
301
|
|
|
175
|
-
|
|
302
|
+
</details>
|
|
303
|
+
|
|
304
|
+
<details>
|
|
305
|
+
<summary><strong>AI</strong></summary>
|
|
306
|
+
|
|
176
307
|
| Tool | Description |
|
|
177
308
|
|------|-------------|
|
|
178
309
|
| `ai_context` | Build LLM context |
|
|
@@ -181,32 +312,29 @@ Works with **all MCP clients** — no client-side changes required.
|
|
|
181
312
|
| `ai_plan` | Generate dev plan |
|
|
182
313
|
| `ai_tasks` | Generate tasks |
|
|
183
314
|
|
|
184
|
-
|
|
185
|
-
|
|
315
|
+
</details>
|
|
316
|
+
|
|
317
|
+
<details>
|
|
318
|
+
<summary><strong>Session & Auto-Context</strong></summary>
|
|
186
319
|
|
|
187
320
|
| Tool | Description |
|
|
188
321
|
|------|-------------|
|
|
189
|
-
| `session_init` |
|
|
190
|
-
| `session_get_user_context` | Get user preferences
|
|
191
|
-
| `session_capture` | Store context
|
|
192
|
-
| `session_smart_search` | Search with
|
|
193
|
-
| `session_remember` | Quick natural language memory
|
|
194
|
-
| `session_recall` | Quick natural language recall
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
"Initialize session for this workspace"
|
|
322
|
+
| `session_init` | Initialize conversation |
|
|
323
|
+
| `session_get_user_context` | Get user preferences |
|
|
324
|
+
| `session_capture` | Store context to memory |
|
|
325
|
+
| `session_smart_search` | Search with context enrichment |
|
|
326
|
+
| `session_remember` | Quick natural language memory |
|
|
327
|
+
| `session_recall` | Quick natural language recall |
|
|
328
|
+
| `context_smart` | Get relevant context for message |
|
|
329
|
+
| `session_compress` | Compress chat history to memory |
|
|
330
|
+
| `session_summary` | Get compact workspace summary |
|
|
331
|
+
| `session_delta` | Get changes since timestamp |
|
|
200
332
|
|
|
201
|
-
|
|
202
|
-
"Remember we decided to use PostgreSQL for the database"
|
|
203
|
-
"Recall the authentication decisions we made"
|
|
204
|
-
"What are my coding preferences?"
|
|
205
|
-
```
|
|
333
|
+
</details>
|
|
206
334
|
|
|
207
|
-
|
|
335
|
+
---
|
|
208
336
|
|
|
209
|
-
Pre-built
|
|
337
|
+
## 🔌 Pre-built Prompts
|
|
210
338
|
|
|
211
339
|
| Prompt | Description |
|
|
212
340
|
|--------|-------------|
|
|
@@ -219,35 +347,26 @@ Pre-built prompts for common workflows:
|
|
|
219
347
|
| `analyze-refactoring` | Find refactoring opportunities |
|
|
220
348
|
| `build-context` | Build comprehensive LLM context |
|
|
221
349
|
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
| Resource | Description |
|
|
225
|
-
|----------|-------------|
|
|
226
|
-
| `contextstream:openapi` | OpenAPI specification |
|
|
227
|
-
| `contextstream:workspaces` | Workspace listing |
|
|
228
|
-
| `contextstream:projects/{id}` | Projects for workspace |
|
|
229
|
-
|
|
230
|
-
## Error Handling
|
|
350
|
+
---
|
|
231
351
|
|
|
232
|
-
|
|
233
|
-
- **Automatic retries** for transient failures (429, 500, 502, 503, 504)
|
|
234
|
-
- **Exponential backoff** with configurable delays
|
|
235
|
-
- **Detailed error codes** (NETWORK_ERROR, UNAUTHORIZED, RATE_LIMITED, etc.)
|
|
236
|
-
- **Request timeouts** (180s default)
|
|
352
|
+
## ⚙️ Environment Variables
|
|
237
353
|
|
|
238
|
-
|
|
354
|
+
| Variable | Required | Description |
|
|
355
|
+
|----------|----------|-------------|
|
|
356
|
+
| `CONTEXTSTREAM_API_URL` | Yes | API base URL (`https://api.contextstream.io`) |
|
|
357
|
+
| `CONTEXTSTREAM_API_KEY` | Yes | Your API key from contextstream.io |
|
|
239
358
|
|
|
240
|
-
|
|
241
|
-
- No internal endpoints hardcoded — API URL is required
|
|
242
|
-
- Minimal logging — credentials are not echoed
|
|
243
|
-
- Public REST API only — no proprietary logic included
|
|
359
|
+
---
|
|
244
360
|
|
|
245
|
-
## Links
|
|
361
|
+
## 🔗 Links
|
|
246
362
|
|
|
247
363
|
- **Website:** [contextstream.io](https://contextstream.io)
|
|
248
364
|
- **Documentation:** [contextstream.io/docs](https://contextstream.io/docs)
|
|
249
365
|
- **MCP Setup Guide:** [contextstream.io/docs/mcp](https://contextstream.io/docs/mcp)
|
|
366
|
+
- **npm:** [@contextstream/mcp-server](https://www.npmjs.com/package/@contextstream/mcp-server)
|
|
367
|
+
|
|
368
|
+
---
|
|
250
369
|
|
|
251
|
-
## License
|
|
370
|
+
## 📄 License
|
|
252
371
|
|
|
253
372
|
MIT
|
package/package.json
CHANGED
|
@@ -1,10 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@contextstream/mcp-server",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.13",
|
|
4
4
|
"description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"main": "dist/index.js",
|
|
8
|
+
"files": [
|
|
9
|
+
"dist",
|
|
10
|
+
"README.md"
|
|
11
|
+
],
|
|
8
12
|
"bin": {
|
|
9
13
|
"contextstream-mcp": "dist/index.js"
|
|
10
14
|
},
|