@atoms-tech/atoms-mcp 0.47.0 → 0.59.0
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 +30 -14
- package/dist/apps/src/apps/browse/browse-app.html +36 -36
- package/dist/apps/src/apps/coverage/coverage-app.html +18 -18
- package/dist/apps/src/apps/editor/editor-app.html +85 -30
- package/dist/apps/src/apps/import/import-app.html +18 -12
- package/dist/apps/src/apps/mermaid/mermaid-app.html +161 -161
- package/dist/apps/src/apps/summary/summary-app.html +21 -21
- package/dist/apps/src/apps/trace/trace-app.html +17 -17
- package/dist/index.cjs +1 -1
- package/dist/index.js +1 -1
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -9,10 +9,10 @@ MCP server for [ATOMS.tech](https://atoms.tech) — connect AI agents to your re
|
|
|
9
9
|
|
|
10
10
|
```bash
|
|
11
11
|
# 1. Login to your ATOMS account
|
|
12
|
-
npx @atoms-tech/atoms-mcp login
|
|
12
|
+
npx @atoms-tech/atoms-mcp@latest login
|
|
13
13
|
|
|
14
14
|
# 2. Add to Claude Code
|
|
15
|
-
claude mcp add atoms-mcp -- npx @atoms-tech/atoms-mcp
|
|
15
|
+
claude mcp add atoms-mcp -- npx @atoms-tech/atoms-mcp@latest
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
That's it. Claude can now read, create, and manage requirements in your ATOMS projects.
|
|
@@ -44,7 +44,7 @@ Every action is logged with AI actor attribution (`mcp_claude`) and enforces you
|
|
|
44
44
|
| `atoms_search` | Full-text search across items | Read | |
|
|
45
45
|
| `atoms_browse` | Interactive filterable item viewer | Read | Browse viewer |
|
|
46
46
|
| `atoms_get_coverage` | Find requirements without test cases | Read | Coverage heatmap |
|
|
47
|
-
| `atoms_verification_status` | Release-bound verification state per requirement | Read | |
|
|
47
|
+
| `atoms_verification_status` | Release-bound verification state per requirement, and the tests to rerun (also with no Release) | Read | |
|
|
48
48
|
| `atoms_get_history` | Audit trail for an item | Read | |
|
|
49
49
|
| `atoms_export_mermaid` | Generate traceability diagram | Read | |
|
|
50
50
|
| `atoms_trace` | Walk traceability graph (upstream/downstream) | Read | Force-directed graph |
|
|
@@ -79,13 +79,13 @@ ATOMS MCP uses **OAuth 2.1 with PKCE** — the same flow used by GitHub CLI and
|
|
|
79
79
|
|
|
80
80
|
```bash
|
|
81
81
|
# Interactive login (opens browser)
|
|
82
|
-
npx @atoms-tech/atoms-mcp login
|
|
82
|
+
npx @atoms-tech/atoms-mcp@latest login
|
|
83
83
|
|
|
84
84
|
# Check current session
|
|
85
|
-
npx @atoms-tech/atoms-mcp whoami
|
|
85
|
+
npx @atoms-tech/atoms-mcp@latest whoami
|
|
86
86
|
|
|
87
87
|
# Clear credentials
|
|
88
|
-
npx @atoms-tech/atoms-mcp logout
|
|
88
|
+
npx @atoms-tech/atoms-mcp@latest logout
|
|
89
89
|
```
|
|
90
90
|
|
|
91
91
|
**How it works:**
|
|
@@ -100,10 +100,10 @@ You can also set `ATOMS_ACCESS_TOKEN` as an environment variable for CI/headless
|
|
|
100
100
|
## CLI Commands
|
|
101
101
|
|
|
102
102
|
```
|
|
103
|
-
npx @atoms-tech/atoms-mcp login # Authenticate with ATOMS
|
|
104
|
-
npx @atoms-tech/atoms-mcp logout # Clear stored credentials
|
|
105
|
-
npx @atoms-tech/atoms-mcp whoami # Show current user
|
|
106
|
-
npx @atoms-tech/atoms-mcp --help # Show all commands
|
|
103
|
+
npx @atoms-tech/atoms-mcp@latest login # Authenticate with ATOMS
|
|
104
|
+
npx @atoms-tech/atoms-mcp@latest logout # Clear stored credentials
|
|
105
|
+
npx @atoms-tech/atoms-mcp@latest whoami # Show current user
|
|
106
|
+
npx @atoms-tech/atoms-mcp@latest --help # Show all commands
|
|
107
107
|
```
|
|
108
108
|
|
|
109
109
|
Running without a subcommand starts the MCP server on stdio.
|
|
@@ -113,7 +113,7 @@ Running without a subcommand starts the MCP server on stdio.
|
|
|
113
113
|
### Claude Code
|
|
114
114
|
|
|
115
115
|
```bash
|
|
116
|
-
claude mcp add atoms-mcp -- npx @atoms-tech/atoms-mcp
|
|
116
|
+
claude mcp add atoms-mcp -- npx @atoms-tech/atoms-mcp@latest
|
|
117
117
|
```
|
|
118
118
|
|
|
119
119
|
### Claude Desktop
|
|
@@ -125,7 +125,7 @@ Add to your `claude_desktop_config.json`:
|
|
|
125
125
|
"mcpServers": {
|
|
126
126
|
"atoms-mcp": {
|
|
127
127
|
"command": "npx",
|
|
128
|
-
"args": ["@atoms-tech/atoms-mcp"]
|
|
128
|
+
"args": ["@atoms-tech/atoms-mcp@latest"]
|
|
129
129
|
}
|
|
130
130
|
}
|
|
131
131
|
}
|
|
@@ -133,7 +133,23 @@ Add to your `claude_desktop_config.json`:
|
|
|
133
133
|
|
|
134
134
|
### Cursor / Windsurf
|
|
135
135
|
|
|
136
|
-
Add to your MCP configuration with `command: "npx"` and `args: ["@atoms-tech/atoms-mcp"]`. Refer to your editor's MCP documentation for the exact config file location.
|
|
136
|
+
Add to your MCP configuration with `command: "npx"` and `args: ["@atoms-tech/atoms-mcp@latest"]`. Refer to your editor's MCP documentation for the exact config file location.
|
|
137
|
+
|
|
138
|
+
## Updating atoms-mcp
|
|
139
|
+
|
|
140
|
+
A config with no tag keeps running the copy npx cached the first time, so it does not update on its own. In your MCP client config, set the args to `@atoms-tech/atoms-mcp@latest`, then restart the client:
|
|
141
|
+
|
|
142
|
+
```json
|
|
143
|
+
"args": ["@atoms-tech/atoms-mcp@latest"]
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
If your config writes `-y` today, keep it:
|
|
147
|
+
|
|
148
|
+
```json
|
|
149
|
+
"args": ["-y", "@atoms-tech/atoms-mcp@latest"]
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
atoms-mcp checks for a newer version once a day and tells you in `atoms_status` and in the next tool result. Set `ATOMS_MCP_NO_UPDATE_CHECK=1` to turn the check off.
|
|
137
153
|
|
|
138
154
|
## Org-Controlled Policy
|
|
139
155
|
|
|
@@ -163,7 +179,7 @@ Set to `1` (or `true`) to drop every mutating tool. Useful for analyst agents, C
|
|
|
163
179
|
"mcpServers": {
|
|
164
180
|
"atoms-mcp": {
|
|
165
181
|
"command": "npx",
|
|
166
|
-
"args": ["@atoms-tech/atoms-mcp"],
|
|
182
|
+
"args": ["@atoms-tech/atoms-mcp@latest"],
|
|
167
183
|
"env": { "ATOMS_MCP_READ_ONLY": "1" }
|
|
168
184
|
}
|
|
169
185
|
}
|