@utaba/ucm-mcp-server 1.0.1 → 1.0.3
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 +3 -26
- package/dist/tools/core/PublishArtifactTool.js +1 -1
- package/package.json +1 -1
- package/package.json.backup +1 -1
package/README.md
CHANGED
|
@@ -2,33 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
Universal Context Manager (UCM) Model Context Protocol (MCP) server for AI-native package management.
|
|
4
4
|
|
|
5
|
-
## Installation
|
|
6
|
-
|
|
7
|
-
```bash
|
|
8
|
-
# Global installation (recommended)
|
|
9
|
-
npm install -g ucm-mcp-server
|
|
10
|
-
|
|
11
|
-
# Or using the scoped package
|
|
12
|
-
npm install -g @utaba/ucm-mcp-server
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
## Quick Start
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
# Start the MCP server (uses default URL https://ucm.utaba.ai)
|
|
19
|
-
ucm-mcp-server --auth-token YOUR_AUTH_TOKEN
|
|
20
|
-
|
|
21
|
-
# Or specify a custom UCM URL
|
|
22
|
-
ucm-mcp-server --ucm-url https://custom.ucm.url --auth-token YOUR_AUTH_TOKEN
|
|
23
|
-
```
|
|
24
|
-
|
|
25
5
|
Get your auth token from https://ucm.utaba.ai
|
|
26
6
|
|
|
27
7
|
## Configuration
|
|
28
8
|
|
|
29
|
-
The UCM MCP server accepts the following parameters:
|
|
30
|
-
|
|
31
|
-
- `--ucm-url <url>`: UCM API base URL (default: https://ucm.utaba.ai)
|
|
32
9
|
- `--auth-token <token>` (required): Authentication token in format `{authorid}:{apikey}`
|
|
33
10
|
|
|
34
11
|
## Available MCP Tools
|
|
@@ -37,7 +14,7 @@ The server provides 11 MCP tools following the `mcp_ucm_` naming convention:
|
|
|
37
14
|
|
|
38
15
|
### System Tools
|
|
39
16
|
- `mcp_ucm_health_check` - Check MCP server and UCM API connectivity
|
|
40
|
-
- `mcp_ucm_quickstart` - Get the UCM quickstart guide
|
|
17
|
+
- `mcp_ucm_quickstart` - Get the UCM quickstart guide (Tell your AI to load this first)
|
|
41
18
|
|
|
42
19
|
### Discovery Tools
|
|
43
20
|
- `mcp_ucm_get_author_index` - Generate dynamic markdown index for an author
|
|
@@ -73,7 +50,7 @@ Add to your Claude Desktop configuration:
|
|
|
73
50
|
## Usage with Claude Code
|
|
74
51
|
|
|
75
52
|
```bash
|
|
76
|
-
claude mcp add -s user ucm-mcp-server npx ucm-mcp-server --auth-token your-
|
|
53
|
+
claude mcp add -s user ucm-mcp-server npx ucm-mcp-server --auth-token your-authtoken-here
|
|
77
54
|
```
|
|
78
55
|
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.
|
|
79
56
|
## Documentation
|
|
@@ -84,4 +61,4 @@ For detailed documentation, visit:
|
|
|
84
61
|
|
|
85
62
|
## License
|
|
86
63
|
|
|
87
|
-
|
|
64
|
+
BSD-3-Clause - See LICENSE file for details
|
|
@@ -146,7 +146,7 @@ export class PublishArtifactTool extends BaseToolController {
|
|
|
146
146
|
Please verify your input parameters and try again.`);
|
|
147
147
|
}
|
|
148
148
|
if (errorMessage?.includes('Invalid namespace format')) {
|
|
149
|
-
throw new McpError(McpErrorCode.InvalidParams, `Invalid namespace format: "${
|
|
149
|
+
throw new McpError(McpErrorCode.InvalidParams, `Invalid namespace format: "${errorMessage}". The namespace must follow the pattern "${this.publishingAuthorId || 'author'}/repository/category/subcategory" where repository is 'main' (for MVP) and category is one of: commands, services, patterns, implementations, contracts, guidance, project. Example: "${this.publishingAuthorId || '0000000000'}/main/commands/user"`);
|
|
150
150
|
}
|
|
151
151
|
throw error;
|
|
152
152
|
}
|
package/package.json
CHANGED