@damper/mcp 0.1.3 → 0.1.5
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 +61 -10
- package/dist/index.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -15,12 +15,13 @@ Damper → Settings → API Keys → Generate
|
|
|
15
15
|
|
|
16
16
|
### 2. Configure Your AI Agent
|
|
17
17
|
|
|
18
|
-
**Claude Code** (`~/.claude.json`):
|
|
18
|
+
**Claude Code** (`~/.claude.json` or `~/.config/claude/claude.json`):
|
|
19
19
|
```json
|
|
20
20
|
{
|
|
21
21
|
"mcpServers": {
|
|
22
22
|
"damper": {
|
|
23
|
-
"command": "
|
|
23
|
+
"command": "npx",
|
|
24
|
+
"args": ["@damper/mcp"],
|
|
24
25
|
"env": { "DAMPER_API_KEY": "dmp_..." }
|
|
25
26
|
}
|
|
26
27
|
}
|
|
@@ -40,25 +41,75 @@ Damper → Settings → API Keys → Generate
|
|
|
40
41
|
}
|
|
41
42
|
```
|
|
42
43
|
|
|
44
|
+
### Multiple Projects
|
|
45
|
+
|
|
46
|
+
Each API key is tied to one project. For multiple projects, configure separate server entries:
|
|
47
|
+
|
|
48
|
+
**Claude Code** (`~/.claude.json` or `~/.config/claude/claude.json`):
|
|
49
|
+
```json
|
|
50
|
+
{
|
|
51
|
+
"mcpServers": {
|
|
52
|
+
"damper-frontend": {
|
|
53
|
+
"command": "npx",
|
|
54
|
+
"args": ["@damper/mcp"],
|
|
55
|
+
"env": { "DAMPER_API_KEY": "dmp_frontend_xxx" }
|
|
56
|
+
},
|
|
57
|
+
"damper-backend": {
|
|
58
|
+
"command": "npx",
|
|
59
|
+
"args": ["@damper/mcp"],
|
|
60
|
+
"env": { "DAMPER_API_KEY": "dmp_backend_xxx" }
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
The AI will see tools from both servers and can distinguish between them:
|
|
67
|
+
- "list tasks from damper-frontend"
|
|
68
|
+
- "start the auth bug in damper-backend"
|
|
69
|
+
|
|
43
70
|
## Tools
|
|
44
71
|
|
|
45
72
|
| Tool | Description |
|
|
46
73
|
|------|-------------|
|
|
47
|
-
| `list_tasks` | Get roadmap tasks |
|
|
48
|
-
| `get_task` | Task details + feedback |
|
|
49
|
-
| `create_task` | Create task (
|
|
50
|
-
| `start_task` |
|
|
74
|
+
| `list_tasks` | Get roadmap tasks (filter by `status`, `type`) |
|
|
75
|
+
| `get_task` | Task details + linked feedback |
|
|
76
|
+
| `create_task` | Create task with type (bug, feature, improvement, task) |
|
|
77
|
+
| `start_task` | Lock and start task (use `force` to take over) |
|
|
51
78
|
| `add_note` | Add progress note |
|
|
52
|
-
| `complete_task` | Mark done |
|
|
79
|
+
| `complete_task` | Mark done, release lock |
|
|
80
|
+
| `abandon_task` | Release lock, return to planned |
|
|
53
81
|
| `list_feedback` | Browse user feedback |
|
|
54
|
-
| `get_feedback` | Feedback details |
|
|
82
|
+
| `get_feedback` | Feedback details + votes |
|
|
83
|
+
|
|
84
|
+
### Task Types
|
|
85
|
+
|
|
86
|
+
Filter tasks by type to prioritize work:
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
> List all bugs
|
|
90
|
+
> Work on the first feature
|
|
91
|
+
> Show me improvement tasks
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Types: `bug` 🐛, `feature` ✨, `improvement` 💡, `task` 📌
|
|
95
|
+
|
|
96
|
+
### Task Locking
|
|
97
|
+
|
|
98
|
+
When you start a task, it's locked to prevent other agents from working on it simultaneously:
|
|
99
|
+
|
|
100
|
+
- Same agent starting again → success (idempotent)
|
|
101
|
+
- Different agent starting → fails with 409 (use `force: true` to take over)
|
|
102
|
+
- Complete or abandon → releases lock
|
|
55
103
|
|
|
56
|
-
## Usage
|
|
104
|
+
## Usage Examples
|
|
57
105
|
|
|
58
106
|
```
|
|
59
107
|
> What tasks are available?
|
|
108
|
+
> List bugs I can fix
|
|
60
109
|
> Import my TODO.md into Damper
|
|
61
|
-
> Work on the dark mode
|
|
110
|
+
> Work on the dark mode feature
|
|
111
|
+
> I'm done with the auth task - tests pass
|
|
112
|
+
> Abandon the current task, I'm blocked
|
|
62
113
|
```
|
|
63
114
|
|
|
64
115
|
## Environment
|
package/dist/index.js
CHANGED