@pragmatic-growth/memory-mcp 2.1.0 → 2.1.1

package/README.md

@@ -1,19 +1,53 @@
-# NT-Memory MCP (stdio)
+# PG-Memory MCP (stdio proxy)
 
-Local MCP stdio server for NT-Memory tax knowledge base. Use this with Raycast and other stdio-only MCP clients.
+Stdio proxy for PG-Memory - connects stdio-based MCP clients to your PG-Memory HTTP server.
+
+## Two Transport Modes
+
+PG-Memory supports **two MCP transport modes**:
+
+### 1. HTTP Transport (Direct)
+For clients that support HTTP/SSE transport (Claude Code, mcp-remote):
+```json
+{
+  "mcpServers": {
+    "pg-memory": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://your-server.up.railway.app/api/mcp"],
+      "env": {
+        "API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### 2. Stdio Transport (This Package)
+For clients that only support stdio (Raycast, local tools):
+```json
+{
+  "name": "pg-memory",
+  "type": "stdio",
+  "command": "npx",
+  "args": ["-y", "@pragmatic-growth/memory-mcp"],
+  "env": {
+    "MCP_API_KEY": "your-api-key"
+  }
+}
+```
 
 ## Two Operating Modes
 
-The server supports two modes for different use cases:
+Both transports support two operating modes:
 
 ### Read-Only Mode (Default)
 Safe for general use - only search and read operations:
-- `search_tax_knowledge` - Semantic search
+- `search_knowledge` - Semantic search with relevance scores
 - `answer_question` - RAG with auto-generation
 - `get_article` - Get article by ID
-- `list_articles` - Browse articles
-- `list_categories` - List categories with counts
-- `log_unanswered` - Flag gaps
+- `list_articles` - Browse articles with category filter
+- `list_categories` - List categories with article counts
+- `log_unanswered` - Flag knowledge gaps
 - `health_check` - System status
 
 ### Full Mode (with `--full` flag)
@@ -29,10 +63,10 @@ Includes all read-only tools PLUS write operations:
 
 ```json
 {
-  "name": "nt-memory",
+  "name": "pg-memory",
   "type": "stdio",
   "command": "npx",
-  "args": ["-y", "@anthropic/nt-memory-mcp"],
+  "args": ["-y", "@pragmatic-growth/memory-mcp"],
   "env": {
     "MCP_API_KEY": "your-api-key-here"
   }
@@ -43,10 +77,10 @@ Includes all read-only tools PLUS write operations:
 
 ```json
 {
-  "name": "nt-memory-full",
+  "name": "pg-memory-full",
   "type": "stdio",
   "command": "npx",
-  "args": ["-y", "@anthropic/nt-memory-mcp", "--full"],
+  "args": ["-y", "@pragmatic-growth/memory-mcp", "--full"],
   "env": {
     "MCP_API_KEY": "your-api-key-here"
   }
@@ -56,17 +90,17 @@ Includes all read-only tools PLUS write operations:
 ### Global Installation
 
 ```bash
-npm install -g @anthropic/nt-memory-mcp
+npm install -g @pragmatic-growth/memory-mcp
 ```
 
 Then run directly:
 
 ```bash
 # Read-only mode (default)
-MCP_API_KEY=your-key nt-memory-mcp
+MCP_API_KEY=your-key memory-mcp
 
 # Full mode
-MCP_API_KEY=your-key nt-memory-mcp --full
+MCP_API_KEY=your-key memory-mcp --full
 ```
 
 ## Environment Variables
@@ -85,13 +119,13 @@ Note: The `--full` CLI flag takes precedence over `MCP_MODE` env var.
 
 | Tool | Description |
 |------|-------------|
-| `search_tax_knowledge` | Search US non-resident tax knowledge base using semantic similarity |
-| `answer_question` | Get AI-powered answers with sources (generates articles if needed) |
-| `get_article` | Retrieve complete article content by ID |
-| `list_articles` | Browse recent articles with optional category filter |
+| `search_knowledge` | Semantic search with relevance scores |
+| `answer_question` | Full RAG pipeline with auto-generation |
+| `get_article` | Retrieve complete article by ID |
+| `list_articles` | Browse articles with optional category filter |
 | `list_categories` | List all categories with article counts |
-| `log_unanswered` | Flag questions as unanswered for gap analysis |
-| `health_check` | Check system status, database connectivity, and current mode |
+| `log_unanswered` | Flag questions for knowledge gap analysis |
+| `health_check` | Check system status and connectivity |
 
 ### Full Mode Tools
 
@@ -102,15 +136,34 @@ Note: The `--full` CLI flag takes precedence over `MCP_MODE` env var.
 | `remove_article` | Soft-delete an article (preserves data for audit) |
 | `rate_answer` | Rate previous answers: -1 (unhelpful), 0 (neutral), 1 (helpful) |
 
+## MCP Resources
+
+| URI | Description |
+|-----|-------------|
+| `pgmemory://categories` | List all knowledge base categories |
+| `pgmemory://stats` | System statistics (article count, gaps, latency) |
+| `pgmemory://recent` | Recently added/updated articles |
+
+## MCP Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `system-context` | Knowledge base context for AI assistants |
+| `search-tips` | Guidelines for effective search queries |
+
 ## How It Works
 
-This package runs locally as a stdio MCP server and proxies requests to the remote NT-Memory HTTP server on Railway. This allows Raycast (which only supports stdio) to use our cloud-hosted knowledge base.
+This package runs locally as a stdio MCP server and proxies requests to the remote PG-Memory HTTP server. This allows clients that only support stdio to use the cloud-hosted knowledge base.
 
 ```
-Raycast (stdio) → nt-memory-mcp (local) → HTTP → Railway (cloud)
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│  Raycast/Local  │────▶│  memory-mcp     │────▶│  PG-Memory      │
+│  (stdio only)   │     │  (this package) │     │  HTTP Server    │
+└─────────────────┘     └─────────────────┘     └─────────────────┘
+        stdio                  proxy                   HTTP
 ```
 
-The server also respects the remote server's mode configuration. For full mode to work:
+For full mode to work:
 1. The stdio proxy must have `--full` flag OR `MCP_MODE=full`
 2. The remote server must have `MCP_MODE=full` in its environment
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pragmatic-growth/memory-mcp",
-  "version": "2.1.0",
-  "description": "MCP stdio client for PG-Memory knowledge base - connect AI agents to your PostgreSQL knowledge base via Model Context Protocol",
+  "version": "2.1.1",
+  "description": "Stdio proxy for PG-Memory - connects stdio-based MCP clients (Raycast, local tools) to your PG-Memory HTTP server. PG-Memory supports both HTTP transport (Claude Code, mcp-remote) and stdio transport (this package).",
   "main": "dist/index.js",
   "bin": {
     "memory-mcp": "./dist/index.js"
@@ -15,12 +15,17 @@
   "keywords": [
     "mcp",
     "model-context-protocol",
+    "stdio",
+    "http",
     "raycast",
+    "claude-code",
     "knowledge-base",
     "postgresql",
     "pgvector",
     "ai",
-    "rag"
+    "rag",
+    "semantic-search",
+    "memory"
   ],
   "author": "Pragmatic Growth",
   "license": "MIT",

package/.npmrc.bak

@@ -1,2 +0,0 @@
-@pragmatic-growth:registry=https://registry.npmjs.org/
-//registry.npmjs.org/:_authToken=${NPM_TOKEN}