@amplis/mcp-server 0.3.0 → 0.3.2
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 +96 -0
- package/package.json +32 -7
package/README.md
ADDED
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# AMPLIS MCP Server
|
|
2
|
+
|
|
3
|
+
Connect Claude, Cursor, and other AI tools to your live [AMPLIS](https://amplis.com.au) consulting data -- projects, people, clients, timesheets, knowledge base, and more.
|
|
4
|
+
|
|
5
|
+
## Quick Start
|
|
6
|
+
|
|
7
|
+
### 1. Authenticate
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npx @amplis/mcp-server login
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Your browser will open for secure authentication via your AMPLIS account. Credentials are stored at `~/.amplis/credentials.json` with strict file permissions.
|
|
14
|
+
|
|
15
|
+
Alternatively, paste an API key manually:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
npx @amplis/mcp-server login-key
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
### 2. Configure Your AI Tool
|
|
22
|
+
|
|
23
|
+
**Claude Desktop** -- add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
|
|
24
|
+
|
|
25
|
+
```json
|
|
26
|
+
{
|
|
27
|
+
"mcpServers": {
|
|
28
|
+
"amplis": {
|
|
29
|
+
"command": "npx",
|
|
30
|
+
"args": ["-y", "@amplis/mcp-server"]
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**Claude Code (CLI)**:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
claude mcp add amplis npx @amplis/mcp-server
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
**Cursor** -- add to `.cursor/mcp.json` in your project:
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"mcpServers": {
|
|
47
|
+
"amplis": {
|
|
48
|
+
"command": "npx",
|
|
49
|
+
"args": ["-y", "@amplis/mcp-server"]
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## What's Included
|
|
56
|
+
|
|
57
|
+
| Type | Count | Examples |
|
|
58
|
+
|------|-------|---------|
|
|
59
|
+
| **Tools** | 35 | Create tasks, log time, manage clients, search knowledge, track credentials, store memories, log decisions |
|
|
60
|
+
| **Resources** | 36 | Projects, pipeline, people, clients, timesheets, capabilities, availability, utilization, knowledge base |
|
|
61
|
+
| **Prompts** | 13 | Weekly status, project health, compliance check, meeting prep, invoice draft, risk assessment |
|
|
62
|
+
|
|
63
|
+
## CLI Commands
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
npx @amplis/mcp-server login # Browser-based login (recommended)
|
|
67
|
+
npx @amplis/mcp-server login-key # Paste API key manually
|
|
68
|
+
npx @amplis/mcp-server status # Show authentication status
|
|
69
|
+
npx @amplis/mcp-server logout # Remove stored credentials
|
|
70
|
+
npx @amplis/mcp-server help # Show help
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## Environment Variables
|
|
74
|
+
|
|
75
|
+
| Variable | Description |
|
|
76
|
+
|----------|-------------|
|
|
77
|
+
| `AMPLIS_ORG_ID` | Override org ID (skips credentials file -- useful for CI/Docker) |
|
|
78
|
+
| `AMPLIS_USER_ID` | Override user ID for audit logging |
|
|
79
|
+
| `AMPLIS_API_URL` | API base URL (default: `https://app.amplis.com.au`) |
|
|
80
|
+
|
|
81
|
+
## Security
|
|
82
|
+
|
|
83
|
+
- API keys follow the format `amplis_` + 64 hex characters (32 random bytes)
|
|
84
|
+
- Keys are SHA-256 hashed before storage in the database -- the full key is shown once at creation
|
|
85
|
+
- Local credentials stored with `0600` file permissions (owner read/write only)
|
|
86
|
+
- Browser login uses state tokens for CSRF protection
|
|
87
|
+
- Keys support permission scopes: `read`, `write`, `admin`
|
|
88
|
+
- Keys can be rotated atomically in the AMPLIS web app under Settings
|
|
89
|
+
|
|
90
|
+
## Documentation
|
|
91
|
+
|
|
92
|
+
Full API reference with all tools, resources, and prompts: [amplis.com.au/docs](https://amplis.com.au/docs)
|
|
93
|
+
|
|
94
|
+
## License
|
|
95
|
+
|
|
96
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,18 +1,46 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@amplis/mcp-server",
|
|
3
|
-
"version": "0.3.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.3.2",
|
|
4
|
+
"description": "MCP server for AMPLIS - connect Claude, Cursor, and other AI tools to your live consulting data",
|
|
5
|
+
"author": "AMPLIS (https://amplis.com.au)",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"homepage": "https://amplis.com.au/docs",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "https://github.com/amplis-au/mcp-server.git"
|
|
11
|
+
},
|
|
12
|
+
"bugs": {
|
|
13
|
+
"url": "https://github.com/amplis-au/mcp-server/issues"
|
|
14
|
+
},
|
|
15
|
+
"keywords": [
|
|
16
|
+
"mcp",
|
|
17
|
+
"mcp-server",
|
|
18
|
+
"model-context-protocol",
|
|
19
|
+
"amplis",
|
|
20
|
+
"consulting",
|
|
21
|
+
"ai-tools",
|
|
22
|
+
"claude",
|
|
23
|
+
"project-management"
|
|
24
|
+
],
|
|
5
25
|
"type": "module",
|
|
6
26
|
"bin": {
|
|
7
27
|
"mcp-server": "./dist/index.js",
|
|
8
28
|
"amplis-mcp": "./dist/index.js"
|
|
9
29
|
},
|
|
10
30
|
"files": [
|
|
11
|
-
"dist"
|
|
31
|
+
"dist",
|
|
32
|
+
"README.md"
|
|
12
33
|
],
|
|
34
|
+
"engines": {
|
|
35
|
+
"node": ">=20"
|
|
36
|
+
},
|
|
37
|
+
"publishConfig": {
|
|
38
|
+
"access": "public"
|
|
39
|
+
},
|
|
13
40
|
"scripts": {
|
|
14
41
|
"dev": "tsx watch src/index.ts",
|
|
15
|
-
"build": "tsup src/index.ts --format esm --dts",
|
|
42
|
+
"build": "tsup src/index.ts --format esm --dts && chmod +x dist/index.js",
|
|
43
|
+
"prepublishOnly": "npm run build",
|
|
16
44
|
"start": "node dist/index.js",
|
|
17
45
|
"typecheck": "tsc --noEmit",
|
|
18
46
|
"test": "vitest run",
|
|
@@ -24,9 +52,6 @@
|
|
|
24
52
|
"open": "^10.0.0",
|
|
25
53
|
"zod": "^3.22.4"
|
|
26
54
|
},
|
|
27
|
-
"publishConfig": {
|
|
28
|
-
"access": "public"
|
|
29
|
-
},
|
|
30
55
|
"devDependencies": {
|
|
31
56
|
"@types/node": "^20",
|
|
32
57
|
"tsup": "^8.0.0",
|