harmony-mcp 1.0.3 → 1.1.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 +48 -6
- package/dist/cli.js +693 -17
- package/dist/index.js +163 -7
- package/dist/init.js +413 -0
- package/package.json +10 -6
package/README.md
CHANGED
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
# harmony-mcp
|
|
2
2
|
|
|
3
|
-
MCP (Model Context Protocol) server for Harmony Kanban board. Enables Claude Code,
|
|
3
|
+
MCP (Model Context Protocol) server for Harmony Kanban board. Enables AI coding agents (Claude Code, OpenAI Codex, Cursor, Windsurf) to interact with your Harmony boards.
|
|
4
4
|
|
|
5
5
|
## Features
|
|
6
6
|
|
|
7
7
|
- **20+ MCP Tools** for full board control (cards, columns, labels, subtasks)
|
|
8
|
+
- **Agent Session Tracking** - track work progress with timer badges
|
|
9
|
+
- **Multi-Agent Support** - works with Claude Code, Codex, Cursor, Windsurf
|
|
10
|
+
- **One-Command Setup** - auto-configure all supported agents
|
|
8
11
|
- **Natural Language Processing** via voice-nlu edge function
|
|
9
12
|
- **API Key Authentication** - no database credentials required
|
|
10
13
|
|
|
@@ -29,19 +32,30 @@ npm install -g harmony-mcp
|
|
|
29
32
|
harmony-mcp configure --api-key hmy_your_key_here
|
|
30
33
|
```
|
|
31
34
|
|
|
32
|
-
|
|
35
|
+
### 4. Initialize for Your AI Agents
|
|
33
36
|
|
|
34
37
|
```bash
|
|
35
|
-
|
|
38
|
+
# Auto-detect and configure all installed agents
|
|
39
|
+
harmony-mcp init --detect
|
|
40
|
+
|
|
41
|
+
# Or configure all supported agents
|
|
42
|
+
harmony-mcp init --all
|
|
43
|
+
|
|
44
|
+
# Or configure specific agents
|
|
45
|
+
harmony-mcp init --agent claude codex cursor windsurf
|
|
36
46
|
```
|
|
37
47
|
|
|
38
|
-
|
|
48
|
+
This creates the necessary configuration files and workflow prompts for each agent.
|
|
49
|
+
|
|
50
|
+
### Manual Setup (Alternative)
|
|
51
|
+
|
|
52
|
+
If you prefer manual setup for Claude Code:
|
|
39
53
|
|
|
40
54
|
```bash
|
|
41
55
|
claude mcp add harmony -- harmony-mcp serve
|
|
42
56
|
```
|
|
43
57
|
|
|
44
|
-
Or add
|
|
58
|
+
Or add to `~/.claude/settings.json`:
|
|
45
59
|
|
|
46
60
|
```json
|
|
47
61
|
{
|
|
@@ -54,12 +68,34 @@ Or add manually to `~/.claude/settings.json`:
|
|
|
54
68
|
}
|
|
55
69
|
```
|
|
56
70
|
|
|
57
|
-
|
|
71
|
+
## Supported AI Agents
|
|
72
|
+
|
|
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
|
+
|
|
80
|
+
## Card Workflow
|
|
81
|
+
|
|
82
|
+
When you start working on a card (e.g., `/hmy #42`):
|
|
83
|
+
|
|
84
|
+
1. **Find** - Locates the card by short ID, UUID, or name
|
|
85
|
+
2. **Move** - Moves the card to "In Progress" column
|
|
86
|
+
3. **Label** - Adds the "agent" label to indicate AI is working
|
|
87
|
+
4. **Track** - Starts a session timer visible in the UI
|
|
88
|
+
5. **Implement** - Work on the task with progress updates
|
|
89
|
+
6. **Complete** - Move to "Review" when done
|
|
58
90
|
|
|
59
91
|
## CLI Commands
|
|
60
92
|
|
|
61
93
|
```bash
|
|
62
94
|
harmony-mcp configure # Set up API key
|
|
95
|
+
harmony-mcp init # Initialize for AI agents (interactive)
|
|
96
|
+
harmony-mcp init --all # Configure all supported agents
|
|
97
|
+
harmony-mcp init --detect # Auto-detect and configure installed agents
|
|
98
|
+
harmony-mcp init --agent X Y # Configure specific agents
|
|
63
99
|
harmony-mcp status # Show current config
|
|
64
100
|
harmony-mcp reset # Clear configuration
|
|
65
101
|
harmony-mcp set-workspace ID # Set active workspace
|
|
@@ -105,6 +141,12 @@ harmony-mcp serve # Start MCP server
|
|
|
105
141
|
### Natural Language
|
|
106
142
|
- `harmony_process_command` - Process natural language commands
|
|
107
143
|
|
|
144
|
+
### Agent Session Tracking
|
|
145
|
+
- `harmony_start_agent_session` - Start tracking work on a card
|
|
146
|
+
- `harmony_update_agent_progress` - Update progress, status, blockers
|
|
147
|
+
- `harmony_end_agent_session` - End session (completed/paused)
|
|
148
|
+
- `harmony_get_agent_session` - Get current session state
|
|
149
|
+
|
|
108
150
|
## Direct API Access
|
|
109
151
|
|
|
110
152
|
You can also call the Harmony API directly from any HTTP client:
|