@contextstream/mcp-server 0.2.5 → 0.2.7

package/README.md

@@ -1,6 +1,10 @@
 # ContextStream MCP Server
 
-A powerful Model Context Protocol (MCP) server that provides code context, memory, knowledge graphs, and AI tools for developers. Connect your AI assistant to your codebase's semantic search, memory system, and dependency analysis.
+[![npm version](https://badge.fury.io/js/@contextstream%2Fmcp-server.svg)](https://www.npmjs.com/package/@contextstream/mcp-server)
+
+A powerful Model Context Protocol (MCP) server that provides persistent memory, code context, knowledge graphs, and AI tools. Connect your AI assistant to your codebase's semantic search, memory system, and dependency analysis.
+
+**Website:** [contextstream.io](https://contextstream.io) | **Docs:** [contextstream.io/docs/mcp](https://contextstream.io/docs/mcp)
 
 ## Features
 
@@ -29,62 +33,66 @@ A powerful Model Context Protocol (MCP) server that provides code context, memor
 - **Plan generation** — AI-powered development planning
 - **Task generation** — Break down work into actionable tasks
 
-## Quickstart
+## Installation
 
-```bash
-cd mcp/contextstream-mcp
-cp .env.example .env  # Edit with your API details
-npm install
-npm run dev           # Start MCP server (stdio)
-```
+Add ContextStream to your AI tool's MCP configuration:
 
-## Client Configuration
+### Cursor / VS Code
+```json
+{
+  "mcpServers": {
+    "contextstream": {
+      "command": "npx",
+      "args": ["@contextstream/mcp-server"],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "your_api_key"
+      }
+    }
+  }
+}
+```
 
-### Cursor / VS Code MCP
+### Claude Code
 ```json
 {
   "mcpServers": {
     "contextstream": {
-      "command": "npm",
-      "args": ["run", "dev"],
-      "cwd": "/path/to/contextstream/mcp/contextstream-mcp",
+      "command": "npx",
+      "args": ["@contextstream/mcp-server"],
       "env": {
-        "CONTEXTSTREAM_API_URL": "http://localhost:3001/api/v1",
-        "CONTEXTSTREAM_API_KEY": "your-api-key",
-        "CONTEXTSTREAM_WORKSPACE_ID": "optional-default-workspace-uuid",
-        "CONTEXTSTREAM_PROJECT_ID": "optional-default-project-uuid"
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "your_api_key"
       }
     }
   }
 }
 ```
 
-### Claude Desktop
+### Windsurf
 ```json
 {
   "mcpServers": {
     "contextstream": {
-      "command": "node",
-      "args": ["/path/to/contextstream/mcp/contextstream-mcp/dist/index.js"],
+      "command": "npx",
+      "args": ["@contextstream/mcp-server"],
       "env": {
-        "CONTEXTSTREAM_API_URL": "http://localhost:3001/api/v1",
-        "CONTEXTSTREAM_API_KEY": "your-api-key"
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "your_api_key"
       }
     }
   }
 }
 ```
 
+Get your API key at [contextstream.io](https://contextstream.io)
+
 ## Environment Variables
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `CONTEXTSTREAM_API_URL` | Yes | API base URL (e.g., `http://localhost:3001/api/v1`) |
-| `CONTEXTSTREAM_API_KEY` | One of | API key for authentication |
-| `CONTEXTSTREAM_JWT` | One of | JWT token for authentication |
-| `CONTEXTSTREAM_WORKSPACE_ID` | No | Default workspace for operations |
-| `CONTEXTSTREAM_PROJECT_ID` | No | Default project for operations |
-| `CONTEXTSTREAM_USER_AGENT` | No | Custom user agent string |
+| `CONTEXTSTREAM_API_URL` | Yes | API base URL (`https://api.contextstream.io`) |
+| `CONTEXTSTREAM_API_KEY` | Yes | Your API key from contextstream.io |
 
 ## Available Tools
 
@@ -213,28 +221,6 @@ Pre-built prompts for common workflows:
 | `contextstream:workspaces` | Workspace listing |
 | `contextstream:projects/{id}` | Projects for workspace |
 
-## Scripts
-
-```bash
-npm run dev       # Run with tsx (development)
-npm run build     # Compile TypeScript
-npm start         # Run compiled version
-npm run typecheck # Type check without emit
-```
-
-## Architecture
-
-```
-src/
-├── index.ts      # Server bootstrap
-├── config.ts     # Environment configuration
-├── http.ts       # HTTP client with retries
-├── client.ts     # ContextStream API client
-├── tools.ts      # MCP tools (55+ tools)
-├── resources.ts  # MCP resources
-└── prompts.ts    # MCP prompts (8 workflows)
-```
-
 ## Error Handling
 
 The client includes:
@@ -250,6 +236,12 @@ The client includes:
 - Minimal logging — credentials are not echoed
 - Public REST API only — no proprietary logic included
 
+## Links
+
+- **Website:** [contextstream.io](https://contextstream.io)
+- **Documentation:** [contextstream.io/docs](https://contextstream.io/docs)
+- **MCP Setup Guide:** [contextstream.io/docs/mcp](https://contextstream.io/docs/mcp)
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextstream/mcp-server",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
   "type": "module",
   "license": "MIT",

package/.env.example

@@ -1,5 +0,0 @@
-CONTEXTSTREAM_API_URL=http://localhost:8085/api/v1
-CONTEXTSTREAM_API_KEY=
-# CONTEXTSTREAM_JWT=
-# CONTEXTSTREAM_WORKSPACE_ID=
-# CONTEXTSTREAM_PROJECT_ID=