harmony-mcp 1.1.0 → 1.1.1
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 +39 -31
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -70,12 +70,12 @@ Or add to `~/.claude/settings.json`:
|
|
|
70
70
|
|
|
71
71
|
## Supported AI Agents
|
|
72
72
|
|
|
73
|
-
| Agent
|
|
74
|
-
|
|
75
|
-
| **Claude Code**
|
|
76
|
-
| **OpenAI Codex** | `~/.codex/config.toml`
|
|
77
|
-
| **Cursor**
|
|
78
|
-
| **Windsurf**
|
|
73
|
+
| Agent | MCP Config | Workflow Command |
|
|
74
|
+
| ---------------- | ------------------------------------- | ------------------------ |
|
|
75
|
+
| **Claude Code** | `~/.claude/settings.json` | `/hmy #42` |
|
|
76
|
+
| **OpenAI Codex** | `~/.codex/config.toml` | `/prompts:hmy #42` |
|
|
77
|
+
| **Cursor** | `.cursor/mcp.json` | MCP tools auto-available |
|
|
78
|
+
| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` | MCP tools auto-available |
|
|
79
79
|
|
|
80
80
|
## Card Workflow
|
|
81
81
|
|
|
@@ -106,6 +106,7 @@ harmony-mcp serve # Start MCP server
|
|
|
106
106
|
## Available Tools
|
|
107
107
|
|
|
108
108
|
### Card Operations
|
|
109
|
+
|
|
109
110
|
- `harmony_create_card` - Create a new card
|
|
110
111
|
- `harmony_update_card` - Update card properties
|
|
111
112
|
- `harmony_move_card` - Move card to different column
|
|
@@ -115,21 +116,25 @@ harmony-mcp serve # Start MCP server
|
|
|
115
116
|
- `harmony_get_card` - Get card details
|
|
116
117
|
|
|
117
118
|
### Column Operations
|
|
119
|
+
|
|
118
120
|
- `harmony_create_column` - Create new column
|
|
119
121
|
- `harmony_update_column` - Update column properties
|
|
120
122
|
- `harmony_delete_column` - Delete column
|
|
121
123
|
|
|
122
124
|
### Label Operations
|
|
125
|
+
|
|
123
126
|
- `harmony_create_label` - Create new label
|
|
124
127
|
- `harmony_add_label_to_card` - Add label to card
|
|
125
128
|
- `harmony_remove_label_from_card` - Remove label
|
|
126
129
|
|
|
127
130
|
### Subtask Operations
|
|
131
|
+
|
|
128
132
|
- `harmony_create_subtask` - Create subtask
|
|
129
133
|
- `harmony_toggle_subtask` - Toggle completion
|
|
130
134
|
- `harmony_delete_subtask` - Delete subtask
|
|
131
135
|
|
|
132
136
|
### Context Operations
|
|
137
|
+
|
|
133
138
|
- `harmony_list_workspaces` - List workspaces
|
|
134
139
|
- `harmony_list_projects` - List projects
|
|
135
140
|
- `harmony_get_board` - Get full board state
|
|
@@ -139,9 +144,11 @@ harmony-mcp serve # Start MCP server
|
|
|
139
144
|
- `harmony_get_context` - Get current context
|
|
140
145
|
|
|
141
146
|
### Natural Language
|
|
147
|
+
|
|
142
148
|
- `harmony_process_command` - Process natural language commands
|
|
143
149
|
|
|
144
150
|
### Agent Session Tracking
|
|
151
|
+
|
|
145
152
|
- `harmony_start_agent_session` - Start tracking work on a card
|
|
146
153
|
- `harmony_update_agent_progress` - Update progress, status, blockers
|
|
147
154
|
- `harmony_end_agent_session` - End session (completed/paused)
|
|
@@ -158,28 +165,28 @@ curl -X GET "https://gethmy.com/api/workspaces" \
|
|
|
158
165
|
|
|
159
166
|
### API Endpoints
|
|
160
167
|
|
|
161
|
-
| Endpoint
|
|
162
|
-
|
|
163
|
-
| `/workspaces`
|
|
164
|
-
| `/workspaces/:id/projects`
|
|
165
|
-
| `/workspaces/:id/members`
|
|
166
|
-
| `/board/:projectId`
|
|
167
|
-
| `/cards`
|
|
168
|
-
| `/cards/:id`
|
|
169
|
-
| `/cards/:id`
|
|
170
|
-
| `/cards/:id`
|
|
171
|
-
| `/cards/:id/move`
|
|
172
|
-
| `/search?q=query`
|
|
173
|
-
| `/columns`
|
|
174
|
-
| `/columns/:id`
|
|
175
|
-
| `/columns/:id`
|
|
176
|
-
| `/labels`
|
|
177
|
-
| `/cards/:id/labels`
|
|
178
|
-
| `/cards/:id/labels/:labelId` | DELETE | Remove label
|
|
179
|
-
| `/subtasks`
|
|
180
|
-
| `/subtasks/:id/toggle`
|
|
181
|
-
| `/subtasks/:id`
|
|
182
|
-
| `/nlu`
|
|
168
|
+
| Endpoint | Method | Description |
|
|
169
|
+
| ---------------------------- | ------ | -------------------------- |
|
|
170
|
+
| `/workspaces` | GET | List workspaces |
|
|
171
|
+
| `/workspaces/:id/projects` | GET | List projects in workspace |
|
|
172
|
+
| `/workspaces/:id/members` | GET | Get workspace members |
|
|
173
|
+
| `/board/:projectId` | GET | Get full board state |
|
|
174
|
+
| `/cards` | POST | Create card |
|
|
175
|
+
| `/cards/:id` | GET | Get card |
|
|
176
|
+
| `/cards/:id` | PATCH | Update card |
|
|
177
|
+
| `/cards/:id` | DELETE | Delete card |
|
|
178
|
+
| `/cards/:id/move` | POST | Move card |
|
|
179
|
+
| `/search?q=query` | GET | Search cards |
|
|
180
|
+
| `/columns` | POST | Create column |
|
|
181
|
+
| `/columns/:id` | PATCH | Update column |
|
|
182
|
+
| `/columns/:id` | DELETE | Delete column |
|
|
183
|
+
| `/labels` | POST | Create label |
|
|
184
|
+
| `/cards/:id/labels` | POST | Add label to card |
|
|
185
|
+
| `/cards/:id/labels/:labelId` | DELETE | Remove label |
|
|
186
|
+
| `/subtasks` | POST | Create subtask |
|
|
187
|
+
| `/subtasks/:id/toggle` | POST | Toggle subtask |
|
|
188
|
+
| `/subtasks/:id` | DELETE | Delete subtask |
|
|
189
|
+
| `/nlu` | POST | Process natural language |
|
|
183
190
|
|
|
184
191
|
## Configuration
|
|
185
192
|
|
|
@@ -211,13 +218,14 @@ Your configuration is stored in `~/.harmony-mcp/config.json`:
|
|
|
211
218
|
│
|
|
212
219
|
▼
|
|
213
220
|
┌──────────────────┐
|
|
214
|
-
│
|
|
215
|
-
│ (
|
|
221
|
+
│ Database │
|
|
222
|
+
│ (Supabase) │
|
|
216
223
|
└──────────────────┘
|
|
217
224
|
```
|
|
218
225
|
|
|
219
226
|
**Key Benefits:**
|
|
220
|
-
|
|
227
|
+
|
|
228
|
+
- No Database credentials needed - just a Harmony API key
|
|
221
229
|
- Any Harmony user can use it
|
|
222
230
|
- Business logic stays in Harmony
|
|
223
231
|
- Centralized security and rate limiting
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "harmony-mcp",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.1",
|
|
4
4
|
"description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -13,11 +13,11 @@
|
|
|
13
13
|
],
|
|
14
14
|
"repository": {
|
|
15
15
|
"type": "git",
|
|
16
|
-
"url": "
|
|
16
|
+
"url": "https://github.com/Way/getharmony/tree/main/packages/mcp-server"
|
|
17
17
|
},
|
|
18
18
|
"homepage": "https://gethmy.com",
|
|
19
19
|
"bugs": {
|
|
20
|
-
"url": "https://github.com/
|
|
20
|
+
"url": "https://github.com/Way/getharmony/issues"
|
|
21
21
|
},
|
|
22
22
|
"keywords": [
|
|
23
23
|
"mcp",
|