@utaba/ucm-mcp-server 1.0.0 → 1.0.2

package/README.md

@@ -2,30 +2,10 @@
 
 Universal Context Manager (UCM) Model Context Protocol (MCP) server for AI-native package management.
 
-## Installation
-
-```bash
-# Global installation (recommended)
-npm install -g ucm-mcp-server
-
-# Or using the scoped package
-npm install -g @utaba/ucm-mcp-server
-```
-
-## Quick Start
-
-```bash
-# Start the MCP server
-ucm-mcp-server --ucm-url https://ucm.utaba.ai --auth-token YOUR_AUTH_TOKEN
-```
-
 Get your auth token from https://ucm.utaba.ai
 
 ## Configuration
 
-The UCM MCP server requires the following parameters:
-
-- `--ucm-url <url>` (required): UCM API base URL
 - `--auth-token <token>` (required): Authentication token in format `{authorid}:{apikey}`
 
 ## Available MCP Tools
@@ -34,7 +14,7 @@ The server provides 11 MCP tools following the `mcp_ucm_` naming convention:
 
 ### System Tools
 - `mcp_ucm_health_check` - Check MCP server and UCM API connectivity
-- `mcp_ucm_quickstart` - Get the UCM quickstart guide
+- `mcp_ucm_quickstart` - Get the UCM quickstart guide (Tell your AI to load this first)
 
 ### Discovery Tools
 - `mcp_ucm_get_author_index` - Generate dynamic markdown index for an author
@@ -60,7 +40,6 @@ Add to your Claude Desktop configuration:
       "command": "npx",
       "args": [
         "ucm-mcp-server",
-        "--ucm-url", "https://ucm.utaba.ai",
         "--auth-token", "YOUR_AUTH_TOKEN"
       ]
     }
@@ -68,6 +47,12 @@ Add to your Claude Desktop configuration:
 }
 ```
 
+## Usage with Claude Code
+
+```bash
+claude mcp add -s user ucm-mcp-server npx ucm-mcp-server --auth-token your-authtoken-here
+```
+Note: The above adds it to your user scope and will be available in all of your projects.  You can remove `-s user` for project scope.
 ## Documentation
 
 For detailed documentation, visit:
@@ -76,4 +61,4 @@ For detailed documentation, visit:
 
 ## License
 
-MIT - See LICENSE file for details
+BSD-3-Clause - See LICENSE file for details

package/dist/index.js

@@ -13,7 +13,7 @@ async function main() {
         .name('ucm-mcp-server')
         .description('Universal Context Manager - Read the mcp_ucm_quickstart first to avoid mistakes')
         .version('1.0.0')
-        .requiredOption('-u, --ucm-url <url>', 'UCM API base URL')
+        .option('-u, --ucm-url <url>', 'UCM API base URL (defaults to https://ucm.utaba.ai)')
         .option('-p, --port <port>', 'Server port', '3001')
         .option('--log-level <level>', 'Log level', 'ERROR')
         .option('--auth-token <token>', 'Authentication token for UCM API format is {auhtorid}:{apikey}. Get one from https://ucm.utaba.ai')

package/dist/server/McpConfig.js

@@ -50,9 +50,6 @@ export class McpConfig {
         return authors;
     }
     validateConfig() {
-        if (!this.config.ucmApiUrl) {
-            throw new Error('UCM API URL is required');
-        }
         if (!this.config.ucmApiUrl.startsWith('http')) {
             throw new Error('UCM API URL must be a valid HTTP/HTTPS URL');
         }

package/dist/tools/core/GetArtifactTool.js

@@ -69,7 +69,6 @@ export class GetArtifactTool extends BaseToolController {
                 response.metadata = {
                     id: artifact.id,
                     version: artifact.metadata?.version || pathComponents.version || 'latest',
-                    name: artifact.metadata?.name,
                     description: artifact.metadata?.description,
                     author: author,
                     repository: pathComponents.repository,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/ucm-mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Universal Context Manager MCP Server - AI-native artifact management",
   "main": "dist/index.js",
   "type": "module",

package/package.json.backup

@@ -1,6 +1,6 @@
 {
   "name": "ucm-mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Universal Context Manager MCP Server - AI-native artifact management",
   "main": "dist/index.js",
   "type": "module",